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“所 以 ， 你 打算 把 我 调 到 开发 岗位 吗 ? ” 
“ 嗯 ， 我 是 这 样 想 的 。 


从 此 ， 我 成 了 一 名 Java 开发 者 。 不 久 ， 我 便 接手 了 一 个 写 得 很 糟糕 并 且 满 是 bug 的 ETL f£ 
序 ， 它 所 依赖 的 框架 早 在 我 读 高 中 的 时 候 就 已 经 废弃 了 ， 而 且 没 有 测试 代码 。 我 天 真 地 想 : 我 学 
Java 差不多 有 一 年 了 ， 对 我 来 说 ， 添 加 测试 应 该 不 难 ， 只 要 仔细 地 重 构 代码 就 行 了 。 但 是 ， 这 些 
XML 文件 有 什么 用 ? 独立 文件 中 的 SQL 是 怎么 进入 DAO 和 DAOImp1 的 ?程序 中 为 什么 有 Ant 
和 Maven 的 构建 脚本 ? (这 个 问题 我 一 直 没 想 明 白 。) Ant 和 Maven 又 是 什么 ? 我 又 是 Google 
搜索 ， 又 是 请 教 专家 ， 还 动手 做 了 试验 ， 最 终 才 好 不 容易 搞定 了 这 些 问题 。 然 而 ， 写 完 自 己 第 一 
个 真正 的 Java 程序 时 ， 想 起 这 种 语言 的 巨大 反差 带 给 我 的 折磨 ， 我 仍然 惊 现 甫 定 。 


多 年 后 , 我 晋升 为 高 级 开发 工程 师 ， 团 队 决 定 新 招 一 名 初级 开发 人 员 。 来 了 一 个 小 伙 子 , 他 
大 学 毕业 刚 一 年 ， 在 之 前 的 工作 中 主要 使 用 JavaScript。 但 是 ， 他 在 学 校 学 过 Java， 并 且 很 有 天 
分 。 实 际 上 ， 他 的 毕业 设计 是 用 C++ 语言 从 零 开 始 编写 了 一 个 3D AUB ABR, R 
给 他 展示 了 一 个 小 的 Web 应 用 ， 这 个 应 用 以 后 就 由 他 来 做 ， 并 向 他 介绍 了 整个 项 目 。 很 快 ， 我 
就 发 现 他 对 Java 的 理解 只 停留 在 语言 层面 ， 和 几 年 前 的 我 一 模 一 样 ， 而 且 他 对 Maven, MyBatis 
及 Tomcat 一 概 不 懂 。 


对 我 来 说 ,为 自己 的 无 知 找 个 借口 很 容易 ， 比 如 没有 系统 地 学 习 过 计算 机 科学 。 这 个 小 伙 子 
虽然 在 学 校 学 过 编程 ,可 还 是 被 难 住 了 .我们 的 求学 道路 截然 不 同 ,但 结果 都 是 一 名 不 合格 的 Java 
开发 者 。 事 实证 明 ， 大 多 数 Java 教学 只 停留 在 对 标准 库 的 讲解 上 。 我 编写 本 书 的 初衷 是 希望 自 
己 当 初 开 始 学 Java 时 能 有 这 样 一 本 书 。 我 希望 在 你 开始 Java 职业 生涯 时 ， 本 书 能 给 你 提供 一 些 
帮助 。 祝 你 编码 快乐 ! 
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1.1 目标 读者 


如 书 名 所 示 ， 本 书 针 对 的 是 在 商业 环境 中 使 用 Java 的 人 士 。 根 据 我 的 个 人 经 验 ， 学习 Java 
体系 几乎 和 学 习 Java 语 言 一 样 困难 。 对 经 验 丰 富 的 程序 员 来 说 , 相 比 于 学 习 Java 体系 , 学 习 Java 
语言 可 能 没什么 难度 。 虽然 学 习 Java 语 言 有 大 量 工具 可 利用 , 但 是 介绍 Java 体系 的 资源 并 不 多 。 
本 书 旨 在 介绍 编写 专业 Java 软件 所 需 的 各 种 框架 、 工 具 和 库 。 

不 管 你 是 刚 毕业 ,还 是 自学 过 编程 ， 只 要 你 想 进 入 这 个 领域 , 本 书 都 能 为 你 提供 大 量 实 用 知 
识 ， 招 聘 主管 会 很 看 重 你 是 否 具备 这 些 知 识 。 实 际 工作 中 ， 你 可 能 根本 不 需要 写 什 么 排序 算法 ， 
但 你 肯定 会 遇 到 使 用 Hibernate 实现 持久 化 的 Spring MVC Web 应 用 。 另 一 方面 , 如果 你 已 经 是 一 
名 专业 开发 者 ， 并 且 理 解 了 相关 概念 ， 那 你 更 有 可 能 问 自己 :“Java 是 如 何 实 现 …… 的 ?” 


本 书 不 教授 Java 基础 知识 ! 阅 读本 书 需 要 了 解 Java 标 准 类 库 。 如 果 你 确实 需要 从 头 学 习 Java， 
建议 你 首先 阅读 Head First Java， 然 后 再 阅读 一 本 比较 新 的 深入 讲解 Java 8 的 书 。 


如 果 你 准备 好 学 习 如 何 开发 企业 级 Java 应 用 了 ， 那 就 开始 吧 ! 
























































1.2 ”如 何 使 用 本 书 
本 书 每 章 都 会 讲 一 个 一 般 性 概念 , 而 且 在 某 种 程度 上 , 各 章 相 互 依赖 。 所 以 , 如 果 你 有 时 间 ， 
建议 从 头 到 尾 阅 读本 书 。 不 过 ， 如 果 你 时 间 有 限 ， 可 以 只 阅读 感 兴 趣 的 章节 。 


文字 解释 的 效果 有 限 ， 所 以 本 书 会 着 重 于 代码 呈现 。 相 关 代码 都 在 正文 中 给 出 了 , 但 简洁 起 
见 ， 省 略 了 一 些 样板 代码 。 访 问 本 书 中 文 版 页 面 (http:/Avww.ituring.com.cn/book/2438 )， 可 以 找 
到 完整 的 项 目 代码 ”。 
































CD 你 也 可 提交 中 文 版 勘误 。 编者 注 











2 Fle 入 门 介绍 








示例 代码 形式 如 下 。 
OrderService.java 
27 public void save(Order order) { 
28 try(Session session = sessionFactory.openSession()) { 
29 Transaction tx = session.beginTransaction(); 
30 session.persist(order); 
31 tx.commit(); 
32 ) // Session 自动 关闭 
33 } 





其 他 用 于 讨论 或 演示 的 代码 形式 如 下 。 


public class HelloWorld { 
public static void main(String[] args) { 
System.out.println("Hello, World!"); 
j 
j 


本 书 篇 幅 不 大 ,我 们 不 会 详细 讲解 任何 工具 。 很 多 情况 下 ,已 有 专门 的 图 书 详细 讲解 了 某 个 
工具 。 本 书 旨 在 简要 介绍 一 些 工具 及 其 基本 用 法 。 如 果 你 想 学 习 更 多 相关 内 容 ,请 进一步 阅读 每 
章 后 面 的 参考 资源 。 


阅读 本 书 过 程 中 ， 你 会 见 到 如 下 标志 。 






































Q ` 到 底 是 什 
架 开 发 者 喜欢 用 一 些 花哨 的 词 描述 其 工具 。 比 如 ,“Apache Maven 是 一 个 软件 
了 目 管理 和 理解 工具 ”就 很 不 容易 理解 。 阅 读 这 些 部 分 , 你 可 以 快速 了 解 某 个 工 
具 的 具体 用 途 。 


Q Java Ji 
Java 是 一 门 比较 老 的 语言 , 向 后 兼容 性 较 好 。 所 以 目前 还 存在 许多 过 时 的 用 法 和 
大 量 废弃 的 标准 库 ， 本 书 称 其 为 “Java 2” 


M4 ZE% 
这 是 一 个 警告 , 提醒 你 注意 在 遗留 系统 中 可 能 遇 到 的 一 些 东西 。 你 应 该 尽量 避免 
在 新 项 目 中 使 用 这 些 东西 。 
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P» 超前 警告 
这 与 上 一 个 标志 正好 相反 。 它 提醒 你 注意 Java 中 一 些 新 引入 的 “东西 ”>， 它 们 可 
能 尚未 被 广泛 采用 。 这 不 一 定 是 坏事 ， 只 是 提醒 你 注意 。 


E 
rr 


o 更 多 内 容 
这 里 给 出 了 更 多 相关 信息 ,以 补充 正文 中 提 到 的 内 容 。 它 们 并 不 是 特别 重要 , 但 
是 如 果 你 感 兴趣 ， 可 以 把 它 作为 延伸 阅读 。 


1.3 ”搭建 环境 


1.3.1 安装 Java 
安装 Java 的 方法 有 很 多 种 ， 请 根据 你 所 用 的 操作 系统 和 个 人 喜好 来 选择 。 
Homebrew (macOS): brew cask install java 
Chocolatey ( Windows ): choco install jdk9 
Apt-Get (Linux): sudo apt-get install default-jdk 


SDKMAN! (类 Unix); sdk install java 


官方 安装 方法 : 访问 Oracle 官网 ， 根 据 相 关 提示 进行 安装 。 请 确保 安装 的 是 JDK 而 非 JRE. 
如 果 你 选择 了 这 种 安装 方法 ， 请 务必 认真 阅读 Oracle IDK 的 许可 协议 ( 相关 内容 见 下 一 章 )。 








这 些 工 具 会 把 Java 放 到 你 的 PATH 变量 中 。 为 了 确认 这 一 点 , 可 在 命令 行 中 输入 java -version, 
输出 信息 如 下 所 示 。 
java version "1.8.0 1341" 


Java(TM) SE Runtime Environment (build 1.8.0 131-b11) 
Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, mixed mode) 


此 外 ， 你 可 能 还 需 设 置 JAVA_HOME 环境 变量 ， 许 多 使 用 Java 的 工具 都 会 首先 查看 它 它 。 你 也 
可 以 在 一 台 机 器 上 安装 多 个 Java 版 本 ， 只 需 把 JAVA HOME 指向 主 版 本 即 可 ， 这 在 测试 Java 新 版 
本 时 很 有 用 。 




















1.8.0 ”集成 开发 环境 


常用 的 Java 集成 开发 环境 (IDE) 有 三 种 ,分别 为 Eclipse, IntelliJ 和 Netbeans, 我 青睐 IntelliJ, 
因为 它 的 功能 集 丰 富 ， 并 且 集 成 了 大 量 开发 框架 。 不 过 ， 这 三 者 之 中 ， 只 有 Inteli 推出 了 付费 
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版 也 不 错 , 我 家 中 计算 机 安装 的 就 是 社区 版 。 对 于 工作 项 目 ， 强 烈 建 议 使 用 付 





有 些 公司 为 了 定制 的 插件 和 设置 , 明确 要 求 开 发 者 使 用 特定 的 IDE 开发 环境 , 实 为 多 此 一 举 。 
为 从 技术 上 讲 ， 在 命令 行 中 可 以 编译 任何 Java 代码 ， 所 以 开发 者 选用 哪 款 IDE 编写 代码 其 实 
无 所 谓 。 
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2.4 何 为 Java 虚拟 机 


多 年 来 ， 支 持 多 平台 一 直 是 Java 的 卖点 之 一 。 比 如 ， 你 在 Mac 上 编写 和 测试 Java 代码 ， 然 
后 将 其 部 署 到 Windows 服务 器 上 ， 它 也 能 正常 运行 。 这 是 因为 编译 好 的 代码 和 操作 系统 之 间 有 
— Java 虚拟 机 ( JVM )， 它 可 以 把 Java 转换 成 本 地 系统 调用 。 准 确 地 说 ， 具 体 承 担 这 个 转换 任 
务 的 是 一 个 JVM 实例 。JVM 既 可 以 指 Java 虚拟 机 规范 ， 也 可 以 指 其 某 个 实现 。 




















2.2 JVM 版 本 


Java 维护 者 会 定期 更 新 JVM 规范 。 通 过 这 种 方式 ， 他 们 可 以 给 Java 添加 新 特性 或 对 其 进行 
改进 。 写 作 本 书 时 ，Oracle 公司 发 布 的 Java 最 新 版 本 是 Java 1.9。 方便 起 见 ， 人 们 通常 把 Java 1.9 
简称 为 “Java 9”， 把 Java 1.8 简称 为 “Java 8”， 以 此 类 推 。 
































I« 落后 警告 :过 时 的 JVM 
然而 有 些 公司 对 新 技术 并 不 怎么 上 心 ， 金融 行业 尤为 突出 。 有 些 Java 学 习 资 料 、 
博客 、 新 闻 等 设想 读者 用 的 是 Java 8 或 Java 9， 实 际 上 读者 用 的 却 是 Java 7， 其 


至 是 Java 6。 





明确 程序 将 来 在 哪个 JVM 版 本 上 运行 十 分 重要 ， 在 着 手 开 发 之 前 就 应 该 确定 下 来 。JVM 版 
本 不 同 ,可 使 用 的 Java 语 言 特性 也 不 同 。 然 而 ,不 管 你 编写 Java 代码 时 使 用 的 是 哪个 版 本 的 JVM， 
你 都 可 以 在 自己 的 机 器 上 安装 最 新 的 JVM 来 运行 。 这 是 因为 Java 有 着 良好 的 向 后 兼容 特性 ， 比 
如 ， 针 对 JVM 1.6 编写 的 Java 代码 可 以 在 JVM 1.8 上 正常 运行 。 


为 了 验证 这 一 点 ， 下 面 给 出 两 个 示例 程序 ， 它 们 的 功能 相同 。 
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NamesOld.java 





import java.util.ArrayList; 
import java.util.List; 


public class NamesOld { 
public static void main(String[] args) { 
List«String» names - new ArrayList«String»(); 
names .add( "Foo") ; 
names .add("Bar"); 
for(String name : names) { 
System.out.println(name); 





NamesNew.java 





import java.util.ArrayList; 
import java.util.List; 


public class NamesNew { 
public static void main(String[] args) { 
List<String> names = new ArrayList<>(); 
names .add( "Foo"); 
names .add("Bar"); 


names. forEach(System.out: :println); 


} 











针对 两 个 不 同 版 本 的 JVM， 编 译 上 面 两 段 程序 ， 结 果 如 下 所 示 。 





javac -source 1.6 javac -source 1.8 
NamesOld.java 无 错误 无 错误 
NamesNew.java 两 个 编译 错误 无 错误 


Q Java 9k: 向 后 兼容 性 


Java 维护 者 高 瞻 远 瞩 ， 让 Java 具备 了 良好 的 向 后 兼容 性 ， 这 可 能 是 促使 Java 今 
天 无 处 不 在 的 原因 之 一 。 然 而 ， 这 样 做 也 带 来 了 许多 “和 包 裕 ”， 如 下 所 示 。 


O 自 1997 年 以 来 ,废弃 了 java.util.Date 包 中 的 一 些 方法 。 
口 在 很 大 程度 上 ，java.time.* 已 经 取代 java.util.Date 包 。 
O 泛 型 只 用 于 编译 时 检查 ， 运 行 时 会 被 清除 。 

O const 和 goto 两 个 关键 字 被 保留 ， 但 并 未 实现 。 
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口 所 有 基本 类 型 都 有 封装 类 ， 比 如 int 和 java.lang.Integer, boolean 和 
java.lang.Boolean ， 等 等 。 

口 通常 应 该 尽量 避免 使 用 Hashtable 和 Vector 集合 ,而 使 用 HashMap 和 ArrayList。 
如 果 你 需要 的 集合 要 用 于 并 发 编程 , 那么 应 该 考虑 使 用 java.util.concurrent 包 。 





2.8 JVM 种 类 


其 实 Oracle 推出 了 两 款 JVM 产品 ， 即 Oracle JVM 和 OpenJDK JVM。 几 乎 在 所 有 情况 下 ， 
任 选 一 个 即 可 。 建 议 选 择 在 你 的 系统 中 最 容易 安装 的 那个 。 不 过 请 注意 ， 在 Oracle JVM 中 存在 
一 些许 可 限制 ， 但 OpenJDK 没有 。 如 果 你 在 意 这 些许 可 条 款 ， 建 议 咨询 公司 的 法 务 部 门 。 


另外 值得 一 提 的 是 , 由 于 JVM 规范 是 公开 的 , 所 以 任何 人 都 可 以 打造 自己 的 JVM。 FXE, 
有 些 人 和 有 的 公司 也 这 样 做 了 ， 比 如 IBM 的 J9、Azul 的 Zing, Excelsior 的 JET 等。 这些 第 三 方 
JVM 实现 都 有 各 自 的 宣传 唆 头 ， 但 通常 可 以 归结 为 以 下 三 个 方面 : 针对 不 同 的 操作 系统 、 性 能 
提升 或 添加 了 新 特性 。 


















































Oracle JVM 和 OpenJDK JVM 的 区 别 
两 者 区 别 不 大 。Oracle 官方 博客 中 写 道 : 


ee Oracle JDK 是 在 OpenJDK 7 基础 上 发 布 的 ， 添加 了 更 多 功能 ， 比 如 部 署 
人 代码， 包含 了 Oracle 对 Java Plugin 和 Java WebStart 的 实现 ， 以 及 一 些 闭 源 第 三 方 
组 件 ( 比如 Graphics Rasterizer ) 和 一 些 开源 第 三 方 组 件 ( 像 Rhino )， 还 有 其 他 一 


些 零 碎 的 东西 ， 比 如 额外 的 文档 或 第 三 方 字体 等 。 
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除非 你 的 Java 程序 很 短小 ， 不 然 使 用 命令 行 编译 Java 程序 就 是 自 找 麻烦 ， 下 面 举例 说 明 。 
首先 介绍 一 个 冰激凌 商店 程序 一 一 IScream， 它 是 本 书 大 部 分 示例 代码 的 背景 。IScream 有 如 下 两 


个 类 。 








DailySpecialService.java 











1 package com.letstalkdata.iscream.service; 

2 

3 import com.google.common.collect.Lists; 

4 import java.util.List; 

5 

6 public class DailySpecialService { 

7 

8 public List«String» getSpecials() { 

9 return Lists.newArrayList("Salty Caramel", "Coconut Chip", "Maui Mango"); 
10 } 
141} 

Application.java 

1 package com. letstalkdata.iscream; 

2 

3 import com. letstalkdata.iscream.service.DailySpecialService; 

4 import java.util.List; 

5 

6 public class Application { 

7 public static void main(String[] args) ( 

8 System.out.println("Starting store! \n\n==============\n"); 

9 
10 DailySpecialService dailySpecialService = new DailySpecialService(); 
11 List«String» dailySpecials - dailySpecialService.getSpecials(); 
12 
13 System.out.println("Today's specials are:"); 
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14 dailySpecials.forEach(s -> System.out.println(" - " + s)); 











虽然 这 个 例子 有 点 刻意 ， 但 是 它 用 到 了 Google 的 Guava 代码 库 ( guava-21.0. jar )。 所 以 ， 
在 编译 之 前 ， 我 们 必须 下 载 guava-21.9.jar ， 并 将 其 添加 到 项 目 中 。 





o 更 多 内 容 : jar 文件 


.jar 文 件 其 实 就 是 zip 文件 。 你 可 以 使 用 7-zip 或 unzip 工具 查看 其 内 容 ， 就 像 查 
看 其 他 zip 文件 一 样 。 标 准 的 .jar 文件 包含 相关 Java 类、 资源， 甚至 还 有 其 他 便 
于 分 发 的 ,jar 文件 。“ 疫 jar” 文 件 只 包含 作者 创建 的 类 和 资源 ， 而 “ 胖 jar” 文 件 
还 包含 所 依赖 的 所 有 第 三 方 文件 。 你 所 使 用 的 代码 库 几 乎 都 是 .jar 文件 。 





示例 程序 的 目录 结构 如 下 ， 它 遵循 Java 文件 夹 常用 约定 。 


|— lib 
| L— guava-24.0. jar 
L— src 


L— main 
L— java 
L— com 


L— letstalkdata 
L— iscream 


一 Application. java 
L— service 


L— DailySpecialService. java 


o EZAR: Java 文件 夹 结构 

Java 类 是 以 包 的 形式 组 织 的 ， 定 义 包 时 要 在 文件 顶部 使 用 package 关键 字 。 依 
据 约 定 ， 包 名 通常 以 域名 (比如 com.google ) 开头 ,接着 是 部 门 名 、 代 码 用 途 等 。 
这 样 会 形成 长 长 的 包 名 。 由 于 包 和 目录 存在 一 一 对 应 的 关系 ,所 以 最 终 得 到 的 目 
录 结 构 也 是 层 层 谱 套 的 。 
另 一 个 约定 是 把 程序 或 库 代 码 的 整个 目录 结构 放 入 另外 一 组 文件 夹 
(src/main/java) 中 ， 而 把 测试 代码 放 入 src/test/java 中 。 当 我 们 学 习 构 建 工具 的 
更 多 相关 内 容 时 ， 了 解 这 一 点 尤为 重要 。 





至 此 ， 代 码 已 经 组 织 好 了 ， 所 需 的 第 三 方 库 也 准备 好 了 ， 接 下 来 该 进行 编译 了 。 你 准备 好 
了 吗 ? 




















$ javac -cp ".:lib/x" src/main/java/com/letstalkdata/iscream/x. javaN 
> src/main/ java/com/letstalkdata/iscream/service/x. java 
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首先 , 我 们 要 告诉 Java 编译 器 依 赖 文 件 的 位 置 。Java 会 查找 classpath, 这 可 以 通过 环境 变 
量 进行 设置 。 更 常见 的 做 法 是 在 编译 时 使 用 -cp 参数 ( 如 果 你 用 的 是 Windows， 请 使 用 分 号 “;” 
而 非 冒号 “:” 把 classpath 分 开 )。 接 下 来 ,我 们 要 告诉 编译 器 要 编译 哪些 文件 。 使 用 x 通配符 
能 简化 工作 ， 但 是 我 们 仍然 需要 指定 两 个 目录 ( 而 一 个 真实 的 应 用 程序 往往 有 几 十 个 目录 )。 


运行 上 面 的 命令 后 ，Java 编译 系统 会 在 源 代码 所 在 的 目录 下 生成 杂乱 的 .class 文件 。 为 了 避 
免 出 现 这 种 情况 ， 通 常 如 下 操作 。 


$ javac -cp ".:lib/x" src/main/java/com/letstalkdata/iscream/x. javaN 











































































































> src/main/java/com/letstalkdata/iscream/service/x. java -d ./out 


编译 时 ， 借 助 -d 选项 ， 可 以 另外 指定 编译 后 保存 代码 的 位 置 。 上 面 的 代码 使 用 了 -d 选项 把 
编译 得 到 的 class 文件 保存 到 out 文件 夹 中 。out 文 件 夹 最 好 已 经 存在 ， 和 否则 javac 不 会 运行 。 

如 果 想 让 代码 易于 运行 , 可 以 创建 一 个 “ 胖 jar”。 此 处 不 详 述 细节 , 大 致 的 做 法 是 : 从 Guava 
库 中 提取 所 需 的 类 ， 然 后 创建 一 个 MANIFESTMF 文件 ， 用 以 指定 程序 运行 时 所 需 的 所 有 代码 ， 
之 后 调用 jar 命令 ， 把 需要 的 所 有 Guava 类 和 你 的 类 包含 在 out 目录 中 。 


为 了 解决 上 面 这 些 烦 琐 的 问题 ， 人 们 开发 出 了 构建 工具 。 



































3.1 Ant 


40 多 年 来 ， 人 们 一 直 使 用 make 程序 把 源 代 码 转换 成 应 用 程序 。 因 此 , 在 早期 的 Java 中, 使 
用 make 就 是 顺理成章 的 事 了 。 然 而 C 程序 的 许多 假设 和 约定 并 没有 很 好 地 转移 到 Java 体系 中 。 
为 了 方便 开发 Java Tomcat 应 用 程序 ，James Duncan Davidson 编写 出 了 Ant 工具 。 很 快 ， 其 他 开 
源 项 目 也 开始 使 用 Ant， 从 此 Ant 工具 迅速 普及 开 来 。 




















o 这 到 底 是 什么 ? 
Ant 是 一 个 管理 Java 编译 过 程 的 工具 。 它 的 可 扩展 性 很 强 ,常用 于 编译 代码 、 运 
行 测试 、 创 建构 建 工件 、 部 署 文件 等 。 


KE 落后 警告 : Ant 
尽管 早期 Ant 被 广泛 使 用 ,但 现在 正 逐渐 被 Maven, Gradle 等 新 的 构建 工具 淘汰 。 


3.1.1 构建 文件 


Ant 构建 文件 以 XML 格式 编写 , 通常 称 作 build.xml。 一 说 到 XML 文件 ， 有 些 人 就 其 缩 , 但 
请 放心 ， 小 的 XML 并 不 复杂 。 在 Ant 中 , 不同 的 编译 阶段 叫 作 “目标 ”(target )。 在 构建 文件 中 
定义 好 目标 之 后 ， 就 可 以 使 用 ant TARGET 命令 进行 调用 ， 其 中 TARGET 指 目标 名 称 。 
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常见 目标 如 下 所 示 。 
build.xml 

7 <target name="clean"> 
8 <delete dir="build"/> 
9 </target> 


11 
12 
1 
14 
1 
16 


3 


5 


为 


18 
19 
20 
21 


23 
24 
25 
26 
27 
28 
29 
30 





上 面 的 clean 目标 用 于 “从 头 开 始 ”， 并 且 删 除 所 有 已 有 构件 。 


build.xml 











«target name="compile"> 


«mkdir 


«javac 


«/target» 


dir="build/classes"/> 
srcdir-"src/main/ java" 
destdir="build/classes" 


classpathref="classpath"/> 











显然 ，compile 目标 把 Java 源 代 码 编译 成 class 文件 。 请 注意 


src/main/Javas 


build.xml 























, Java 源 代 码 文件 根 目 录 设 置 








«target name="jar"> 


«mkdir 


dirz"build/jar"/» 


«jar destfile="build/jar/IScream. jar" basedir="build/classes"/> 


«/target» 











jar 目标 把 编 











build.xml 





译 好 的 class 文件 打包 成 jar 文件 ， 并 将 其 放 和 人 指定 目录 中 。 





«target name="run" depends-"jar"» 


«java fork="true" classname-"com.letstalkdata.iscream.Application"» 


«cl 


asspath» 
«path refid="classpath"/> 
«path location="build/jar/IScream. jar"/> 


</classpath> 


«/ java» 
«/target» 





最 后 ，run 目标 将 从 指定 的 主 类 运 














行 整个 应 用 程序 。 


记得 把 Google Guava 库 放 入 classpath 中 ， 如 下 所 示 。 
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build.xml 





«path id="classpath"> 
«fileset dir-"lib" includes="x*x/x.jar"/> 
«/path» 








细心 的 话 ,你 会 发 现 compile 目标 中 已 经 引用 了 elasspath( classpathref= "classpath" )。 
上 面 的 文件 中 还 出 现 了 x*/*， 这 是 一 种 Ant 匹配 模式 ， 类 似 于 超级 通配符 ,用 于 递归 包含 所 有 匹 
配 文 件 。 


完 各 的 构建 文件 如 下 。 E 

















build.xml 

1 «project» 

2 

3 «path id="classpath"> 

4 «fileset dir-"lib" includes="x*x/x.jar"/> 

5 «/path» 

6 

7 <target name="clean"> 

8 <delete dir="build"/> 

9 </target> 

0 

1 «target name="compile"> 

2 «mkdir dir="build/classes"/> 

3 «javac srcdir-"src/main/ java" 

4 destdir="build/classes" 

5 classpathref="classpath"/> 

6 </target> 

7 

8 <target name="jar"> 

9 <mkdir dir="build/jar"/> 
20 <jar destfile="build/jar/IScream. jar" basedir="build/classes"/> 
21 </target> 
22 
23 «target name="run" depends="jar"> 
24 «java fork="true" classname="com. letstalkdata.iscream.Application"> 
25 «classpath» 
26 «path refid="classpath"/> 
2T «path location="build/jar/IScream. jar"/> 
28 </classpath> 





29 «/ java» 
30 </target> 
31 


32 «/project» 








定义 好 这 些 目标 之 后 ， 接 下 来 就 可 以 运行 ant clean, ant compile, ant jar, ant run 
命令 来 编译 、 构 建 和 运行 写 好 的 应 用 程序 了 。 


当然 ， 实 际 项 目的 构建 文件 可 能 比 上 面 那个 复杂 得 多 。Ant 提供 了 大 量 内 置 任务 ， 用 户 也 可 
以 自 定义 任务 。 一 个 标准 的 构建 任务 包括 移动 文件 、 汇 集 文档 、 运 行 测试 、 发 布 构件 等 。 如 果 你 
很 幸运 ,接手 一 个 维护 良好 的 项 目 , 那么 构建 文件 或 许可 以 原封 不 动 地 正常 工作 。 否 则 ,你 可 能 
需要 手动 对 特定 的 计算 机 调整 构建 文件 。 调 整 时 ， 要 留心 构建 文件 所 引用 的 .properties 文件 ， 里 
面 可 能 包含 配置 文件 路 径 、 环 境 设置 等 。 












































3.1.2 ”使 用 Ivy 管理 依赖 


Ant 有 一 个 缺点 一 一 不 支持 依赖 管理 。 构 建 程序 时 ， 我 们 仍 需 手动 下 载 第 三 方 Guava 库 ， 并 
在 构建 文件 中 指明 其 路 径 。Ivy 工具 可 以 为 Ant 添加 依赖 管理 功能 。 


如 果 项 目 使 用 了 ITvy, 那 么 项 目 根 目 录 下 会 存在 一 个 ivy.xml 文件 ,就 在 Ant build.xml 文件 旁 。 
前 面 示 例 项 目的 ivy.xml 文件 如 下 所 示 。 








ivy.xml 
1 <ivy-module version="2.0"> 
2 «info organisation-"com.letstalkdata" module="iscream"/> 
3 «dependencies» 
4 «dependency org="com.google.guava" name="guava" revz"241.0"/» 
5 «/dependencies» 
6 «/ivy-module» 






































当然 , 不 能 随意 设置 依赖 属性 。 通 常 ， 查 找 依赖 属性 最 简单 的 方法 是 去 所 用 库 的 官网 , 或 者 
访问 MVNRepository 网 站 。 就 Guava 库 来 说 ， 你 可 以 访问 MVNRepository 网 站 ， 在 搜索 框 中 输 
入 “guava”， 点 击 所 需 版 本 ， 再 点 击 “Ivy” 选 项 卡 ， 即 可 得 到 依赖 属性 。 











3.1 Ant 15 





€ CGO à Secure | https://mvnrepository.com/artifact/com.google.guava/guava/21.0 


MVNazposirory Bearch for groups, artifacts, categories 


Indexed Artifacts (7.89M) Home > com.google.guava » guava » 21.0 
7888k Sr Note: There is a new version for this artifact 


3944k y^ New Version 23.1-jre 


œ Guava: Google Core Libraries For Java » 2: 


Popular Categories x Guava is à suite of core and expanded libraries that include yl 
collections, io classes, and much much more. 
Aspect Oriented 


Actor Frameworks License | Apache 2.0 | 
App! M 
pplication Metrics Categories 
Build Tools 
| Date (Jan 12, 2017) 
Bytecode Libraries 
: Files Download (BUNDLE) (2.4 MB) 
Command Line Parsers 
Repositories 
Cache Implementations un ma I 
Used By 13,009 artifacts 


| Cloud Computing 


Code Analyzers 
| Maven || Gradie | SBT |) Ivy |, Grape || Leiningen || Buildr | 


| Collections 

| Configuration Libraries «1-- https:/)mvnrepository.com/artifact/com.google.guava/guava --» 

4 «dependency org»*com.google.guava" names"guava* reve*21.0"/» 
Core Utilities 





图 3-1 MVNRepository 网 站 上 的 Guava 
接 下 来 需要 对 Ant 的 构建 文件 做 一 些 修改 。 
(1) 修改 第 一 行 ， 添 加 Ivy Æo 


«project xmlns:ivy="antlib:org.apache.ivy.ant"> 


(2) 添加 一 个 目标 ， 以 解析 依赖 。 


«target name="resolve"> 
<ivy:retrieve /» 
«/target» 


至 此 ， 我 们 就 可 以 运行 ant resolve 命令 来 获取 依赖 ， 并 将 其 放 入 lib 文件 夹 中 了 。 这 一 切 
都 是 自动 进行 的 ， 无 须 手 动 操 作 。 


3.1.3 小 结 


虽然 编写 构建 脚本 要 花 些 时 间 , 但 使 用 它 的 好 处 显而易见 , 借助 它 , 你 不 必 手 动 把 命令 传递 
给 Java。 当 然 ，Ant 自身 也 有 一 些 问题 。 首 先 ，Ant 脚本 的 强制 标准 不 多 。 这 提供 了 极 大 的 灵活 
性 ,但 代价 是 每 个 构建 文件 完全 不 同 。 就 像 你 懂 Java 并 不 意味 着 能 读 懂 所 有 代码 库 一 样 ， 了 解 
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Ant 并 不 意味 着 你 能 读 懂 所 有 Ant 文件 ， 通 常 你 要 花 些 时 间 才 能 理解 。 其 次 ，Ant 本 身 不 限制 构 
建文 件 的 长 度 ， 这 意味 着 它 可 以 变 得 很 长 ， 有 的 build.xml 文件 行 数 甚至 超过 2000。 最 后 ，Ant 
不 支持 依赖 管理 功能 ， 需 要 配合 Ivy 工具 使 用 。 除 了 上 面 这 些 缺 点 外 ，Ant 构建 脚本 还 有 其 他 一 
些 不 足 ， 这 最 终 促成 了 2000 年 初 Maven 的 诞生 。 

















3.2 Maven 


Maven 其 实 是 两 个 工具 的 集合 : 一 个 依赖 管理 器 和 一 个 构建 工具 。 类 似 于 Ant, Maven 也 是 
基于 XML 的 , 但 与 Ant 不 同 的 是 ， 它 的 标准 相当 严格 。 而 且 ，Maven 是 声明 式 的 ， 人 允许 用 户 定 
义 构 建 目 标 ， 而 不 是 方法 。 这 些 优 点 使 得 Maven 大 受 欢 迎 ， 构 建文 件 在 整个 项 目 中 更 为 标准 化 ， 
开发 者 定制 这 些 文件 只 需 花 很 少 的 时 间 。 因 此 ，Maven 在 某 种 程度 上 成 了 Java 体系 中 事实 上 的 
标准 。2016 年 的 一 次 调查 显示 ，68% 的 开发 者 将 Maven 作为 主要 构建 工具 。 



































© 这 到 底 是 什么 ? 
Maven 工具 用 于 管理 Java 代码 库 的 整个 构建 周期 :获取 依赖 、 编 译 代码 、 运 行 
测试 、 创 建构 建 工 件 、 部 署 文件 等 。 此 外 ，Maven 还 支持 扩展 ， 用 户 可 以 使 用 插 
件 运行 自 定 义 任 务 。 


3.2.1 Maven 任务 


Maven 包含 可 以 利用 构建 脚本 实现 的 最 常规 的 任务 。 这 些 任务 称 作 phase， 运 行 mvn PHASE 
(其 中 PHASE 指 任务 名 称 ) 命令 即 可 执行 它们 。 最 常规 的 任务 如 下 所 示 。 


O 编译 (compile): 编译 源 代码 。 

O X (test): 在 项 目 中 运行 单元 测试 。 

口 打包 (package): 创建 代码 发 布 包 ， 比 如 .jar 文件 。 

O 验证 (verify): 在 项 目 中 运行 集成 测试 。 

O 安装 (install): 创建 本 地 可 用 的 发 布 包 ， 这 些 包 可 用 于 其 他 Maven 项目 。 

O 部 署 (deploy): 创建 供 他 人 使 用 的 发 布 包 ,， 这些 包 可 用 于 其 他 Maven 项 目 。(“ 他 人 ” 常 
你 所 在 团队 或 公司 里 的 其 他 人 ， 未 必 是 全 世界 。) 


这 些 任务 是 可 累加 的 ， 比 如 执行 “打包 ”任务 会 引发 “编译 ”和 “测试 ”任务 的 执行 。 关 于 
完整 的 Maven 任务 列表 ,请 参阅 “Lifecycle Reference””。 首 次 运行 Maven 构建 项 目 时 ， 应 该 执 
行 “安装 ”( install ) 任务 , 这样 会 编译 和 测试 整个 项 目 , 创建 一 个 构建 工件 ， 并 将 其 安装 到 本 
地 Maven 仓库 中 。 
























































(D https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html#Lifecycle_Reference 
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虽然 “清理 ”(clean ) 并 非 一 个 真正 的 任务 , 但 mvn clean 这 个 命令 值得 一 提 。 执 行 此 命 
令 将 清空 你 的 本 地 构建 目录 ( 比如 /target )， 删 除 编译 好 的 类 、 资 源 、 包 等 。 理 论 上 ， 只 需 运 行 
mvn install 命令 ， 构 建 目 录 就 会 自动 更 新 。 不 过 很 多 开发 者 (包括 我 本 人 ) 发 现 有 时 它 不 起 作 
用 ， 因 而 习惯 运行 mvn clean install 命令 强制 从 头 构建 项 目 。 























3.22 项 目 对 象 模 型 文件 


我 们 将 Maven 构建 文件 称 为 “项 目 对 象 模型 文件 ”〈(POM )， 它 以 pom.xml 的 形式 存储 在 项 
目的 根 目 录 下 。 为 了 让 Maven 能 够 正常 工作 ， 项 目 需要 采用 如 下 目录 结构 。 





上 一 pom.xml 


L— src 


| | <=- Java 代码 在 此 
| |l— resources 
| 


| <= 应 用 程序 或 库 所 需 的 非 代 码 文件 


| 一 java 
| «—- Java 测试 
|l— resources 


| “< 一 测试 所 需 的 非 代码 文件 


POM 文件 项 部 的 标签 通常 如 下 所 示 。 

















pom.xml 





«groupId»com.letstalkdata«/groupId» 
<artifactId>iscream</artifactId> 
«version»0.0.1-SNAPSHOT«/version» 


Yoo. 


<packaging> jar</packaging> 
































O groupId: 指明 你 的 公司 、 团 队 或 组 织 单位 。 

O artifactId: POM 构建 的 构件 名 。 

O version: 构件 版 本 号 。 构 建成 功 后 ， 后 缀 -SNAPSHOT 表示 mvninstall 和 mvndeploy 会 
自动 奉 换 构件 。 对 于 发 布 版 本 ， 你 应 该 删除 此 后 绥 。 

QO) packaging: 竺 构建 的 构件 类 型 。 


下 面 介绍 依赖 。 前 面 提 过 ，Maven 内 置 了 依赖 管理 功能 。 示 例 项 目的 依赖 如 下 所 示 。 
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pom.xml 





«dependencies» 

«dependency» 
«groupId»com.google.guava«/groupId» 
<artifactId>guava</artifactId> 
«version»21.0«/version» 

«/dependency» 

«/dependencies» 


























All Ivy 一样 ， 查 找 正 确 值 的 最 简单 方法 是 访问 项 目 官 网 或 者 MVNRepository 网 站 。 
POM 的 最 后 一 部 分 是 build 部 分 ， 包 含 构建 可 执行 文件 ( jar 文件 ) 所 需 的 配置 。 


























3.23 插件 
Maven 长 盛 不 衰 的 关键 是 其 借 由 插件 带 来 的 强大 扩展 性 。 技 术 在 不 断 变化 ， 而 Maven 依然 


可 以 存活 下 来 是 因为 它 可 以 扩展 丰富 的 第 三 方 所 
插件 ， 包 括 Web HEAR, x PUER. Android, Docker 等 。 


















































i 件 。 比 如 ， 现 在 你 可 以 找到 各 种 各 样 的 Maven 





对 于 示例 项 目 , 我 们 只 需 用 到 Apache 的 一 个 官方 插件 一 -Shade， 该 插件 可 以 构建 “ 胖 ”jar 
文件 。 
pom.xml 
20 «build» 
21 «plugins» 
22 «plugin» 
23 «groupId»org.apache.maven.plugins«/groupId» 
24 «artifactId»maven-shade-plugin«/artifactId» 
25 <version>2.3</version> 
26 <executions> 
27 <execution> 
28 «phase»package«/phase» 
29 «goals» 
30 «goal»shade«/goal» 
31 </goals> 
32 <configuration> 
33 <transformers> 
34 <transformer implementation= 
35 "org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"» 
36 «mainClass» 
37 com. letstalkdata.iscream.Application 
38 </mainClass> 
39 </trans former > 
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AQ «/transformers» 
41 «/configuration» 
42 «/execution» 

43 </executions> 





上 面 的 代码 涉及 很 多 属性 ,但 这 里 重点 关注 phase (package ) 和 goal (shade )。 这 意味 着 
当 你 运行 mvnpackage (或 者 任何 更 高 层次 的 任务 ) 时 ， 相 关 捕 件 的 shade 目标 就 会 执行 ， 这 里 
用 于 构建 “ 胖 ”jar 文 件 。 


使 用 插件 的 不 便 之 处 是 ， 必 须 把 它们 挂 接 到 Maven 的 生命 周期 中 。 在 上 面 的 示例 中 ，Shade 
重 件 已 经 挂 接 到 了 package. 目标 是 不 能 独立 存在 的 , 创建 自己 的 任务 (phases ) 需要 更 多 XML 
模板 。 


使 用 插件 的 另 一 个 难题 是 其 作用 并 不 直观 , 而 且 如 果 缺 少 好 的 文档 , 也 很 难 配置 正确 。 比 如， 
为 了 告诉 插件 主 类 是 哪 一 个 我们 必须 在 POM 中 向 下 深入 六 层 。 由 于 配置 是 通过 XML 进行 的 ， 
所 以 可 能 对 某 个 合法 XML 文件 ， 持 件 能 够 读 取 它 ， 但 是 不 知道 如 何 解释 它 ， 这 常常 会 引起 一 些 
费解 的 错误 信息 。 建 议 查找 相关 文档 ， 从 你 参与 的 项 目 中 找 一 个 能 够 正常 运作 的 例子 ， 或 者 去 
Stack Overflow 寻求 帮助 。 从 零 开 始 配置 搬 件 往往 是 徒劳 的 。 

至 此 ， 你 就 可 以 运行 mvn package 命令 了 ， 然 后 target 文件 夹 中 会 生成 iscream-0.0.1- 


SNAPSHOT. jar 文件 。 接 着 ， 运 行 java -jar iscream-0.0.1-SNAPSHOT. jar ， 你 会 看 到 熟悉 的 
程序 输出 。 
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3.24 仓库 和 发 布 


尽管 上 面 的 构建 并 不 需要 仓库 (repositories ) 和 发 布 管理 (distributionManagement ), 
但 是 在 公司 内 部 项 目 中 它们 相当 常见 ， 值 得 一 提 。 


在 Maven 中 , 仓库 用 于 存储 构件 , 并 且 Maven 可 以 访问 它 。 默 认 情 况 下 , Maven 认识 Maven 
Central 仓库 并 会 使 用 它 。 首 次 构建 应 用 程序 时 ,构件 会 下 载 到 本 地 仓库 中 。 有 人 打趣 说 : 这 是 在 
下 载 整个 互联 网 ， 因 为 Maven 遍历 的 依赖 树 好 像 无 穷 无 尽 。 不 过 ， 一旦 这 些 构 件 下 载 下 来 并 且 
保存 到 你 的 本 地 计算 机 中 ， 以 后 复 用 的 时 候 就 会 非常 快 了 。 如 果 项 目 需要 使 用 的 构件 存储 在 一 个 
内 部 仓库 中 , 或 者 使 用 的 构件 不 在 Maven Central F, 那么 你 应 该 添加 额外 的 仓库 , 代码 如 下 所 示 。 




















«repositories» 
«repository» 
«id»xyzRepo«/id» 
«name»Company XYZ Repo«/name» 
«url»http://some-server/repo«/url» 
«/repository» 
«/repositories» 
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如 果 你 指定 了 多 个 仓库 ，Maven 会 按照 指定 顺序 检查 这 些 仓库 。 


当 你 需要 部 署 构件 时 ， 就 要 用 到 distributionManagement 部 分 了 。 如 果 你 正在 开发 一 个 内 
部 库 ， 并 且 其 他 开发 者 会 使 用 它 ， 那 么 就 要 用 到 distributionManagement 了 了。 示例 如下。 


«distributionManagement» 














«repository» 
<uniqueVersion> false</uniqueVersion> 
<id>xyzRepo</id> 
<name>Company XYZ Repo</name> 
«url»http://some-server/repo«/url» 

«/repository» 

«snapshotRepository» 

«uniqueVersion»true«/uniqueVersion» 
«id»xyzSnapRepo«/id» 
«name»Company XYZ Snapshot Repo«/name» 
«url»http://some-server/repo-snapshots«/url» 
«layout»legacy«/layout» 

«/snapshotRepository» 

«/distributionManagement» 


O 更 多 内 容 : 仓库 

不 管 你 所 在 团队 的 规模 如 何 , 如果 要 在 项 目 中 使 用 内 部 开发 的 库 , 最 好 创建 一 个 
内 部 仓库 。 否则 ,你 必须 把 库 保 存 到 源 代码 控制 中 。 目前 最 流行 的 仓库 管理 器 是 
Sonatype Nexus, Artifactory 也 在 日 趋 走红 。 
当然 ， 借 助 自己 的 Maven 仓库 ， 你 可 以 保存 任何 构件 ， 不 仅仅 局 限于 内 部 库 。 
建议 保存 Maven Central 中 没有 的 第 三 方 构件 ， 比 如 微软 的 SQL Server 数据 库 驱 
动 程序 。 你 还 可 以 存储 Maven Central 中 存在 的 构件 ， 以 加 快 下 载 速 度 或 者 减少 
项 目的 版 本 碎片 。 事 实 上 ， 有 些 公 司 只 允许 开发 者 使 用 企业 存储 库 中 的 构件 。 


3.2.5 小结 


RE Maven 在 简化 项 目 构 建 方面 已 经 取得 了 很 大 进步 ， 但 在 使 用 Maven 的 过 程 中 我 们 还 是 
会 碰 到 一 些 环 手 的 问题 。 前 面 提 到 了 使 用 搬 件 时 的 一 些 问题 ， 此 外 还 存在 一 个 所 谓 的 “Maven 方 
式 ” 问 题 。 当 某 个 构建 不 符合 Maven 的 要 求 时 ， 就 会 很 难 进 行 下 去 。 许 多 项 目 都 是 “正常 的 …… 
除了 我 们 不 得 不 做 一 些 奇怪 的 事 ”。 而 且 ， 构 建 过 程 中 “怪事 ” 越 多 ，Maven 就 越 不 如 意 。 虽 然 
我 不 太 同 意 一 位 博客 作者 的 观点 ,他 说 “Maven 构建 是 一 个 无 尽 而 绝望 的 循环 ， 它 将 你 慢 慢 拖 
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地 狱 最 深 处 、 最 黑暗 的 深渊 ……”， 但 我 能 够 理解 ! 
如 果 把 Ant 的 灵活 性 和 Maven 的 众多 优点 结合 起 来 ， 那 岂 不 是 更 好 ? ! 这 正 是 Gradle 试图 








实现 的 目标 。 


3.3 Gradle 21 





3.3 Gradle 


第 一 眼看 到 Grade 构建 脚本 时 ， 也 许 你 会 惊讶 于 它 并 未 采用 XML 格式 。 事 实 上 ，Gradle 使 
用 了 一 种 基于 Groovy (一 种 基于 JVM 的 敏捷 开发 语言 ) 的 领域 特定 语言 (DSL )。 




















o 更 多 内 容 : Groovy 
JVM 规范 是 免费 且 公 开 的 ， 人 们 可 以 创造 出 新 的 编程 语言 ， 并 且 使 用 这 些 编程 
语言 编写 的 源 代码 能 够 编译 成 Java 字 节 码 。Groovy 就 是 这 样 一 种 语言 。 虽 然 有 
时 人 们 视 其 为 脚本 语言 (主要 因为 不 需要 定义 任何 类 就 能 运行 代码 )， 但 是 你 完 
全 可 以 用 它 编 写 整个 应 用 程序 。 试 试 吧 1! 





def name = 'World' 
println("Hello, $name!") 


DSL 定义 了 构建 文件 的 核心 部 分 和 具体 的 构建 步骤 (uif "FERE" )。 其 可 扩展 性 使 得 定义 任 
务 很 容易 。 当 然 ，Gradle 也 拥有 丰富 的 第 三 方 插件 库 。 下 面 详细 介绍 。 











Phi 超前 警告 : Gradle 
尽管 Grade 越 来 越 流行 ,但 它 还 是 个 新 事物 。 由 于 整个 Java 体系 进展 缓慢 ， 所 
以 只 在 开源 项 目 中 见 到 它 就 不 足 为 奇 了 。 
3.3.1 构建 文件 


Gradle 构建 文件 名 是 build.gradle， 并 且 从 配置 构建 环境 开始 。 因 为 示例 项 目 需要 用 到 一 个 
“ 胖 ”jar 插 件 ， 所 以 要 把 Shadow 插件 添加 到 构建 脚本 配置 中 。 























build.gradle 





1  buildscript { 

2 repositories { 
3 jcenter () 
4 } 

5 dependencies { 
6 classpath 'com.github. jengelman.gradle.plugins:shadow:1.2.4' 
7 } 

8 j 





为 了 下 载 插件 ，Gradle 必须 在 包含 各 种 构建 索引 的 仓库 中 查找 。 有 几 个 Gradle 库 很 出 名 , 常 
简称 为 mavenCentral() 或 jcenter()。 说 到 仓库 ，Gradle 团队 决定 不 重新 发 明 轮 子 ， 转 而 依靠 
现 有 的 Maven 和 Ivy 依赖 体系 。 
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3.32 任务 


Ant 中 “目标 ”(target ) 和 Maven 中 “任务 ”( phase). 的 含义 都 比较 模糊 ，Gradle 为 构建 步 
又 起 了 一 个 清晰 合理 的 名 字 : 任务 (task )。 我 们 可 以 通过 Gradle 的 apply 命令 访问 指定 任务 。 
( Gradle A T java 插件 ， 所 以 我 们 不 必 在 构建 依赖 中 声明 它 。) 























build.gradle 





10 apply plugin: 'java' 
11 apply plugin: 'com.github.johnrengelman.shadow' 





java 插件 用 于 执行 clean ,compileJava test 等 常规 任务 .shadow 插件 用 于 执行 shadowJar 
任务 ， 创 建 一 个 “ 胖 ”jar。 运 行 gradle -q tasks 命令 ， 可 以 查看 完整 的 任务 列表 。 下 面 列 出 
了 一 些 最 常规 的 任务 。 


O assemble: 组 装 项 目 输出 。 
O build: 组 装 和 测试 项 目 。 

O clean: 删除 构建 目录 。 

O jar: 打包 主要 类 。 

O javadoc: 为 主要 源 代码 生成 Javadoc API 文 档 。 
D test: 运行 单元 测试 。 


任务 配置 在 构建 脚本 中 进行 ， 先 是 任务 名 称 ， 接 着 是 一 个 花 括 号 。 配 置 shadowJar 任务 的 
示例 如 下 。 















































build.gradle 
26 shadowJar { 
27 baseName ='iscream' 
28 manifest { 
29 attributes 'Main-Class': 'com.letstalkdata.iscream.Application' 
30 } 
34 ) 











你 也 可 以 在 构建 文件 中 自 定 义 任务 。 由 于 Gradle DSL 基于 Groovy 编程 语言 ， 所 以 几乎 有 无 
限 可 能 。 例 如 ， 下 面 这 个 任务 负责 打印 要 编译 的 文件 ， 可 以 通过 gradle printClasspath 命令 
调用 它 。 
task printClasspath { 
sourceSets.each { source -> 
println(source) 


def tree - source.compileClasspath.getAsFileTree() 
tree.files.each { f -» println(f.name) } 
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3.8.8 ”依赖 管理 


前 面 介绍 脚本 构建 时 , 讲 过 了 管理 插件 依赖 的 方法 ,同样 的 方法 也 适用 于 管理 代码 依赖 。 我 
们 再 次 创建 一 个 repositories 和 一 个 dependencies。 乍 看 上 去 ， 它 们 与 前 面 buildscript 中 
的 好 像 一 样 ， 但 实际 上 有 很 大 不 同 。buildscript 内 部 的 repositories 和 dependencies 用 于 
运行 构建 本 身 ， 而 buildscript 外 部 的 repositories 和 dependencies 用 于 编译 程序 代码 。 
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build.gradle 








repositories { 
mavenCentral() 


dependencies { 


compile group: 'com.google.guava', name: 'guava', version: 





'21.0' 





完整 的 构建 脚本 如 下 。 


build.gradle 





buildscript { 
repositories { 
jcenter () 


} 


dependencies { 


classpath 'com.github. jengelman.gradle.plugins:shadow:1.2.4' 


apply plugin: 'java' 
apply plugin: 'com.github. johnrengelman.shadow' 


group - 'com.example' 

version z'0.0.1-SNAPSHOT' 
sourceCompatibility - 1.8 
targetCompatibility - 1.8 


repositories { 
mavenCentral() 


dependencies { 


compile group: 'com.google.guava', name: 'guava', version: 


'21.0' 
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28 

26 shadowJar { 

27 baseName = 'iscream' 

28 manifest { 

29 attributes 'Main-Class': 'com.letstalkdata.iscream.Application' 
30 } 

34 ) 











iX FÉ Gradle 就 知道 如 何 找 到 项 目 依赖 了 。 接着 运行 gradle shadowJar , 创建 一 个 包含 Guava 
依赖 项 的 胖 jar。 命 令 执行 完毕 后 ,会 生成 一 个 /build/lib/iscream-0.0.1-SNAPSHOT-alljar， 然 后 你 
可 以 以 常规 方式 (java -jar ...) BRET. 


如 果 项 目 需要 用 到 存储 在 内 部 仓库 中 的 构件 ， 则 用 以 下 两 种 方式 可 以 把 其 他 仓库 添加 进去 ， 
具体 取决 于 仓库 的 类 型 。 














1. Maven 


repositories { 
maven { 
url "http://repo.mycompany.com/maven2" 
} 
} 


2. lvy 
repositories { 
ivy { 
url "http://repo.mycompany.com/repo" 


} 


3.3.4 Gradle 守护 进程 


也 许 你 已 经 注意 到 了 ， 每 次 运行 Gradle 都 会 出 现 如 下 信息 。 








Starting a Gradle Daemon (subsequent builds will be faster) 


Grade Daemon 是 Gradle 的 一 个 特性 ， 旨 在 加 速 项 目 构建 。JVM 启动 慢 是 出 了 名 的 ( 每 个 新 
版 本 在 这 方面 都 有 所 改进 )。Gradle 需要 在 JVM 中 运行 ， 所 以 JVM 启动 慢 会 拖 慢 项 目 构 建 速度 。 
为 了 缓解 这 个 问题 ，Gradle 创建 了 一 个 长 时 间 运 行 的 后 台 进程 。 通 过 这 个 Gradle 守护 进程 ， 只 需 
启动 一 次 JVM， 之 后 就 可 以 重复 使 用 ， 无 须 再 次 启动 ， 这 大 大 缩短 了 项 目的 构建 时 间 。 


在 我 的 机 器 上 ， 第 一 次 运行 gradle clean build 命令 清理 IScream 应 用 程序 耗 时 5.35 $^, 
第 二 次 只 花 了 1.898 秒 。 
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如 果 你 曾 遇 到 项 目 构建 速度 慢 的 情况 , 可 以 使 用 --profile 来 弄 清 楚 时 间 的 使 用 情况 。 它 会 
产生 一 个 HTML 报告 ， 列 出 每 个 任务 的 耗 时 情况 。 


3.8.5 小结 


对 Java 构建 体系 而 言 , Gradle 功能 强大 且 灵 活 。 当然, 高 度 可 定制 的 工具 总 会 伴随 一 些 风 险 ， 
你 必须 留意 构建 文件 的 代码 质量 。 这 不 一 定 是 坏事 , 但 是 团队 在 使 用 这 个 工具 时 应 该 考虑 到 这 一 
点 。 而 且 ，Gradle 的 强大 之 处 多 来 自 第 三 方 搬 件 。 由 于 Gradle 相对 较 新 , 你 可 能 觉得 自己 在 使 用 
由 不 同人 开发 的 一 堆 择 件 。 有 时 你 会 发 现 多 款 插件 有 同样 的 功能 ， 每 款 择 件 在 GitHub 上 都 有 几 
十 颗 星 但 没有 多 少 文档 ， 你 不 得 不 从 中 选择 一 个 。 尽 管 如 此 ，Gradle 还 是 越 来 越 受 欢迎 ,那些 希 
望 对 构建 过 程 有 更 多 控制 权 的 开发 者 尤其 青睐 它 。 
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评估 产品 代码 质量 的 最 佳 方式 是 测试 。Java 提供 了 丰富 的 测试 工具 和 库 。 目 前 最 常用 的 测试 
库 是 JUnit。JUnit 既 可 以 当 单独 的 库 使 用 ， 也 可 以 和 其 他 库 结 合 来 提供 额外 功能 。 所 有 现代 IDE 
都 支持 JUnit 测试 ， 而 且 Maven 和 Gradle 都 支持 test 命令 ， 用 以 运行 检测 到 的 所 有 JUnit 测试 
(在 Ant 中 有 一 个 junit 目标 ), 另 一 个 选择 是 TestNG , 它 提 供 了 JUnit 所 没有 的 许多 功能 .TestNG HN 
也 受到 广泛 支持 ， 不 过 在 某 些 情况 下 你 需要 安装 其 他 插件 才能 使 用 它 。 















































I« 落后 警告 :不 经 测试 
不 论 是 出 于 无 知 、 管 理 不 善 , 还 是 开发 者 的 狂妄 自 大 ,缺少 自动 化 测试 的 代码 屡 
见 不 鲜 。 尤 其 是 当 你 接手 一 个 老 旧 的 Java 应 用 程序 时 ,很 可 能 经 测试 的 代 
码 中 迷失 。 而 隔离 代码 的 一 部 分 并 创建 一 些 广泛 的 测试 , 至 少 可 以 帮助 你 找到 方 
向 ,更 多 细节 ,可 阅读 Working Effectively with Legacy Code 一 书 中 Michael Feather 

对 测试 框架 的 讨论 。 


4.1 [8 IScream 应 用 程序 添加 服务 


回 到 IScream 商店 应 用 程序 的 例子 , 修改 一 下 DailySpecialService 类 , 它 会 查询 一 个 Web 
API 端 点 ， 而 非 返回 一 个 静态 列表 。 假 定 该 服务 返回 一 个 JSON 响应 ， 并 且 我 们 不 知道 ISON 解 
析 库 存在 。 


DailySpecialService.java 





package com.letstalkdata.iscream.service; 


import java.io.BufferedReader; 
import java.io.IOException; 

import java.io.InputStreamReader; 
import java.net.HttpURLConnection; 
import java.net.URL; 

import java.util.ArrayList; 
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import java.util.List; 
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import java.util.regex.Matcher; 
import java.util.regex.Pattern; 


public class DailySpecialService { 


private final String SPECIALS URL - 
"http: //www.mocky.io/v2/59040162100000348034 f66dc" ; 


public List«String» getSpecials() { 

try { 
String json = getJsonFromUrl(); 
return parseF lavorsFromJson( json); 

} catch (IOException e) { 
System.out.println("Error retrieving daily specials!"); 
e.printStackTrace(); 
return new ArrayList<>(); 


private String getJsonFromUrl() throws IOException { 
URL url = new URL(SPECIALS_URL); 


HttpURLConnection con (HttpURLConnection) url.openConnection(); 


try(BufferedReader in - new BufferedReader( 
new InputStreamReader(con.getInputStream()))) { 
String inputLine; 
StringBuilder response - new StringBuilder(); 


while ((inputLine = in.readLine()) != null) { 
response.append(inputLine); 


} 


return response.toString(); 


List<String> parseFlavorsFromJson(String json) { 
// 这 部 分 代码 只 为 说 明 问题 
// 实 际 代码 会 使 用 JSON 解析 库 
final String REGEX PATTERN = "\"flavor\":\"(?<theFlavor>[\\w ]+)\""; 
Pattern flavorRegex - Pattern.compile(REGEX PATTERN); 
Matcher matcher = flavorRegex.matcher( json); 
List<String> flavors = new ArrayList<>(); 
while(matcher.find()) { 
flavors.add(matcher.group("theFlavor")); 
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55 return flavors; 
56 } 
5T ) 





o 更 多 内 容 : Mocky 
如 果 想 快速 生成 一 个 基于 HTTP 的 Web 服务 ， 推 荐 使 用 Mocky。 只 要 提供 响 
代码 、 内 容 类 型 、 响 应 头 和 响应 体 ， 就 能 立即 生成 一 个 永久 URL, € 
的 输入 。 但 要 注意 ，Mocky 并 不 支持 HITPS， 所 以 不 要 发 送 任何 敏感 信 











上 面 的 代码 中 , 我 们 对 parseFlavorsFromJson( ) 方 法 最 感 兴趣 , 它 正 是 我 们 要 测试 的 目标 。 
当然 ， 在 真实 的 应 用 程序 中 ， 我 们 不 会 手动 编写 解析 ISON 的 方法 (第 10 章 将 介绍 JSON 库 )。 
首先 在 src/test/-java/conyletstalkdata/iscream/service/ 文 件 夹 中 创建 DailySpecialServiceTest.java X 
件 。 请 注意 ， 该 目录 和 实际 类 的 目录 结构 一 样 。 这 样 做 有 如 下 三 个 好 处 。 

口 测试 代码 组 织 合理 。 

口 使 用 构建 工具 时 ， 你 可 以 把 test 文件 夹 中 的 内 容 排除 在 构件 外 。 

口 使 用 构建 工具 时 ，test 文件 夹 中 的 文件 会 覆盖 main 文件 夹 中 的 同名 文件 。 这 有 助 于 进行 
即时 测试 ， 稍 后 举例 说 明 。 

使 用 JSON 时 ， 我 常 把 测试 数据 存储 为 静态 文件 ， 并 且 保 存在 代码 之 外 ， 以 保持 代码 整洁 。 
你 可 以 在 sre/test/resources/json-samples 文件 夹 中 找到 这 三 个 例子 "。 









































no-specials.json 


{ 


"specials":[ ] 


} 








one-special.json 





{ 
"specials": [ 
{ 
"flavor": "Salty Caramel", 
"price":3.25 
j 
] 
j 














CD 注意 ,在 使 用 Maven 或 Gradle Itt, src/main/resources 和 src/test/resources 会 自动 包含 在 classpath 中 ， 所 以 我 们 
可 以 直接 使 用 这 些 文件 夹 中 的 文件 。 
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three-specials.json 





{ 
"specials":[ 
{ 
"flavor": "Salty Caramel", 
"price":3.25 
Jg 
{ 
"flavor":"Coconut Chip", 
"price":3.25 
jg 
{ 
"flavor":"Maui Mango", 
"price":3.75 
} 
] 
} 





在 Java 测试 中 ， 我 创建 了 下 面 这 个 辅助 类 来 读 取 JSON。 


DailySpecialServiceTest.java 





19 private static final String TEST, JSON ROOT = 

20 "src/test/resources/ json-samples"; 

21 

22 private String readJsonFromFile(String fileName) throws Exception { 
23 Path jsonPath = Paths.get(TEST_JSON_ROOT, fileName); 

24 return new String(Files.readAllBytes( jsonPath) ); 

25 } 





至 此 ， 骨 架 就 搭建 好 了 ， 下 面 添加 一 些 实际 测试 。 
4.2 编写 测试 


4.2.1 JUnit 


JUnit 是 Java 体系 中 最 常用 的 测试 框架 
NUnit, PHPUnit, CppUnit 等 测试 框架 ， 会 
也 没有 关系 ，JUnit 语法 很 容易 学 。 

所 有 JUnit 测试 方法 都 是 public void 的 ， 并且 带 有 @Test 注解 标签 。 当 然 ， 为 了 让 测试 有 
意义 ， 你 需要 添加 一 条 断言 。 通 常 在 测试 类 中 静态 导入 org. junit.Assert.*， 使 测试 变 得 更 简 








且 遵 循 xUnit 系列 测试 框架 的 标准 。 如 果 你 用 过 
觉得 JUnit 很 熟悉 。 即 使 你 没有 用 过 这 些 测试 框架 ， 





» 
$ 
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洁 。 我 经 常 使 用 assertEquals, assertTrue 和 assertFalse， 当 然 也 可 以 用 其 他 方法 。 下 面 的 
测试 用 于 验证 解析 方法 ， 用 到 了 三 个 模拟 的 JSON 文件 。 
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DailySpecialServiceTest.java 





@Test 
public void GivenZeroSpecials_EmptyListIsReturned() throws Exception { 


String json = readJsonFromFile("no_specials. json"); 
DailySpecialService service = new DailySpecialService(); 
List<String> parsedFlavors = service.parseF lavorsFromJson( json); 


assertTrue(parsedFlavors.isEmpty()); 


@Test 


public void GivenThreeSpecials_ThenThreeF lavorsReturned() throws Exception { 
String json = readJsonFromFile("three_specials. json"); HN 





DailySpecialService service - new DailySpecialService(); 
List«String» parsedFlavors = service.parseF lavorsFromJson( json); 


assertEquals(3, parsedFlavors.size()); 





JUnit 的 一 些 匹配 器 来 自 Hamcrest 测试 框架 ， 添 加 import static org.hamcrest. 


CoreMatchers .+ 语句 后 就 可 以 使 用 了 。 使 用 Hamcrest 编写 断言 如 下 所 示 。 




















DailySpecialServiceTest.java 





@Test 
public void GivenOneSpecial FlavorNameIsExtracted() throws Exception { 


String json = readJsonFromFile("one special. json"); 
DailySpecialService service - new DailySpecialService(); 
List«String» parsedFlavors = service.parseF lavorsFromJson( json); 
assertThat(parsedFlavors.get(@), is(equalTo("Salty Caramel"))); 








有 些 人 偏爱 这 种 “流畅 ”风格 编写 的 测试 ， 但 在 Java 里 我 觉得 这 样 有 点 别扭 。 如 果 你 感 兴 


























趣 ， 可 以 通过 添加 hamcrest-library.jar 库 把 所 有 Hamcrest 匹配 器 添 加 到 应 用 程序 中 。 








4.2.2 TestNG 


其 实 , JUnit 的 许多 特征 来 自 TestNG, 比如 注解 、 分 组 测试 、 参 数 化 测试 等 , 也 就 是 说 , TestNG 








和 JUnit 有 很 多 相似 之 处 。TestNG 也 属于 xUnit 框架 ， 其 测试 方法 也 是 public void WE, 并且 
带 有 @Test 注解 。TestNG 使 用 的 许多 断言 和 JUnit 一 样 ,要 使 用 上 断言 ,需要 在 相应 类 中 加 上 import 


static org.testng.Assert. * 语 句 。 


ni 
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由 于 TestNG 和 JUnit 类似， 所 以 测试 代码 几乎 完全 一 样 。 


DailySpecialServiceTest.java 





@Test 

public void GivenOneSpecial FlavorNameIsExtracted() throws Exception { 
String json = readJsonFromFile( "one special. json"); 
DailySpecialService service - new DailySpecialService(); 
List«String» parsedFlavors - service.parseFlavorsFromJson( json); 
assertEquals(parsedFlavors.get(0), "Salty Caramel"); 




















(这 里 用 了 “几乎 ”这 个 词 ， 因 为 在 TestNG Fil JUnit 中 ，assertEquals() 参 数 的 顺序 是 颠倒 


的 。) 








直到 最 近 ，JUnit 才 开始 支持 分 组 测试 。 分 组 测试 使 得 在 不 同时 间 可 以 执行 不 同 测试 。 比 如 ， 











也 许 有 少量 “ 慢 速 测试 ”并 不 需要 频繁 运行 ， 你 可 以 把 它们 从 “快速 单元 测试 ”中 分 离 出 来 ,， 单 
独 形 成 一 组 。 下 面 是 两 个 测试 例子 ， 其 中 一 个 位 于 一 组 中 。 


如 ， 











GTest(groups = "db-integration") 

public void employeeCanBeSaved() { 
EmployeeService service - new EmployeeService(); 
Employee employee - new Employee("Allie"); 
service.save(employee); 


assertEquals(service.getById(1).getName(), "Allie"); 


@Test 

public void employeeFullNameIsGenerated() { 
Employee employee = new Employee(); 
employee.setFirstName("Allie"); 
employee.setLastName("Park") 


assertEquals(employee.getFullName(), "Allie Park") 
j 


上 面 的 代码 中 ，employeeCanBeSaved 被 放 和 一 组 中 ， 我 们 可 以 根据 需要 运行 那个 分 组 。 比 
在 Grade 中 ， 我 们 可 以 创建 一 个 任务 来 运行 慢 速 数据 库 集成 测试 。 
task dbTest(type: Test, dependsOn: 'test') { 


useTestNG() { 
includeGroups 'db-integration' 





4.3 ”运行 测试 


前 面 提 到 过 ,许多 Java 开发 工具 都 支持 JUnit 和 TestNG 测试 框架 。 在 项 目 开发 过 程 中 ， 通 
过 IDE 运行 测试 是 很 容易 的 。 使 用 IntelliJ 运行 JUnit 测试 的 示例 如 下 。 























图 4-1 在 ItelliJIDE 中 运行 测试 





构建 工具 也 支持 测试 。Gradle 中 测试 失败 的 示例 如 下 。 


$ gradle test 

:compileJava UP-TO-DATE 
:processResources NO-SOURCE 
:classes UP-TO-DATE 
:compileTestJava 
:processTestResources UP-TO-DATE 
:testClasses 

:test 





com.letstalkdata.iscream.service.DailySpecialServiceTest > 
GivenZeroSpecials EmptyListIstReturned FAILED 
java.lang.AssertionError at DailySpecialServiceTest. java:31 


3 tests completed, 1 failed 
:test FAILED 


FAILURE: Build failed with an exception. 


Maven 和 Gradle 还 会 生成 HTML 格式 的 测试 报告 C 两 个 报告 稍 有 不 同 ), 这 对 于 包含 几 十 个 
测试 的 大 型 应 用 程序 特别 有 用 。 测 试 结果 可 在 build ( Gradle ) 或 target (Maven ) 文件 夹 中 找到 。 
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下 面 是 Gradle 为 前 面 的 构建 生成 的 测试 报告 。 


Test Summary 


3 1 0 0.014s 66% 


tests failur ignor: j 
ailures ignored duration süccesslül 


Failed tests Packages Classes 


DailySpecialServiceTest. GivenZeroSpecials. EmptyLististReturned 





图 4-2. Gradle 测试 报告 
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有 时 编写 测试 时 ， 某 些 对 象 难以 处 理 。 通 常 这 些 对 象 会 与 外 部 世界 有 交互 ， 比 如 数据 库 连 接 
器 、 文 件 系 统 读 取 器 、Web 上 下 文 对 象 等 。 测试 替身 用 于 代替 这 些 复杂 的 对 象 , 以 便于 编写 测试 。 
如 果 你 之 前 从 未 接触 过 这 个 概念 ， 强 烈 建议 你 阅读 Martin Fowler HH “Mocks Aren't Stubs” 





一 文 。 当 然 , 许多 Java 框架 可 以 使 用 测试 蔡 身 EasyMock , Mockito, JMockit, jMock, PowerMock 
等 ， 下 面 介绍 其 中 三 个 。 
口 EasyMock 是 最 早出 现 的 框架 之 一 ， 在 老 项 目 中 更 常见 。 





























O 现在 Mockito 是 最 常用 的 模拟 测试 框架 。 
口 PowerMock 建立 在 EasyMock 和 Mockito 基础 之 上 ， 并 添加 了 更 多 功能 。 





4.4.1 为 可 模拟 服务 修改 IScream 

现在 ， 我 们 的 应 用 程序 可 以 产生 一 个 Web 服务 ， 访 问 互联 网 以 确定 每 日 特色 菜 。 在 单元 测 
试 背景 下 ， 这 样 做 慢 上 且 不 可 靠 。HTTP 调用 可 能 会 耗 时 几 秒 ， 并 且 服 务 可 能 不 可 用 。 除 非 我 们 想 
专门 测试 Web 服务 集成 效果 C 比如 在 集成 测试 中 )， 不 然 我 们 并 不 想 直 接 与 互联 网 打交道 。 在 这 
种 情形 下 ，Mock 有 助 于 实现 这 个 目标 。 


我 向 代码 中 添加 了 一 个 新 类 ， 以 便于 测试 编写 。 
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MenuCreatorjava 
1 package com.letstalkdata.iscream; 
2 
3 import com.letstalkdata.iscream.service.DailySpecialService; 
E 
5 import java.util.List; 
6 
7 public class MenuCreator { 
8 
9 private DailySpecialService dailySpecialService; 
0 
1 public MenuCreator(DailySpecialService dailySpecialService) { 
2 this.dailySpecialService - dailySpecialService; 
3 j 
4 
5 public String getTodaysMenu() { 
6 List«String» dailySpecials - dailySpecialService.getSpecials(); 
7 
8 StringBuilder menuBuilder = new StringBuilder("Today's specials are:\n"); 
9 dailySpecials. forEach(s -> 
20 menuBuilder.append(" - ").append(s).append('"\n")); 
24 
22 return menuBuilder.toString(); 
23 } 
24 
25 } 





MenuCreator 构造 函数 包含 了 一 个 DailySpecialService 实例 , 这 是 因为 MenuCreator 
依赖 它 。 并 且 ， 当 那个 实例 传人 时 ， 它 就 被 注入 了 。( “依赖 注入” 这 个 术语 在 第 $ 章 中 特别 
He!) 至 此 ， 我 们 已 经 创建 好 了 MenuCreator ， 接 下 来 就 可 以 在 测试 中 注入 一 个 模拟 的 
DailySpecialService 了 。 





4.4.2 {FA Mocks 创建 测试 
使 用 Mock 的 基本 步骤 如 下 。 


(1) 创建 Mock 对 象 。 

(2) 为 Mock 对 象 设 置 预期 行为 。 

(3) 把 Mock 对 象 注 入 到 测试 对 象 。 

(4) 调用 测试 对 象 。 

(5) 验证 Mock 对 象 行为 是 否 符 合 预期 。 
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其 中 ,步骤 (1)、 步 骤 (2) 和 步骤 (5) 要 用 到 测试 模拟 框架 。 所 以 理论 上 ， 如 果 你 想 改 用 其 他 测 


试 模拟 框架 ， 只 需要 部 分 修改 测试 即 可 。 


4.4.3 EasyMock 


在 EasyMock 中 ,“ 录 制 、 播 放 、 验 证 ”(record replay, verify ) 这 三 个 术语 不 太 好 理解 ， 你 
可 以 把 它们 理解 成 “设置 、 启 动 、 验 证 ”"。 下 面 这 个 测试 就 使 用 了 EasyMock。 




















MenuCreatorTestEasyMock.java 





16 @Test 

17 public void WhenAMenuIsCreated ThenDailySpecialServiceIsCalled() { 
18 // 33K A; 创建 Mock 对 象 

19 DailySpecialService mockService - 

20 EasyMock .createMock(DailySpecialService.class); 

21 

22 //FR2: 设置 预期 行为 

23 List«String» specials = new ArrayList<>(); 

24 EasyMock.expect(mockService.getSpecials()).andReturn(specials).once(); 
25 EasyMock.replay(mockService); 

26 

21 // 3&3; 注入 Mock 对 象 

28 MenuCreator menuCreator = new MenuCreator(mockService); 

29 

30 // 步 又 4: 调用 测试 对 象 

31 menuCreator .getTodaysMenu( ) ; 

32 

33 // 步 骤 5: 验证 

34 EasyMock.verify(mockService); 

35 } 





参考 前 面 讲 的 5 MER, WETS, EasyMock.create 
EasyMock.expect() 对 应 步骤 (2)。 我 们 希望 只 调用 一 次 服务 ， 并 | 


Mock() 方 法 对 应 步骤 (1) ， 
且 服 务 被 调用 时 会 返回 菜单 





( 这 里 只 是 一 个 空 列表 )。 紧 接着 执行 EasyMock .replay() 方 法 , 启用 Mock 对 象 。 步 又 (3)、 步 
又 (4) 和 EasyMock 无 关 , 不 论 使 用 什么 框架 , 它们 都 是 不 变 的 。 最 后 , 使 用 EasyMock.verify() 
验证 Mock 对 象 的 行为 是 否 符合 预期 。 当 你 运行 测试 时 ,测试 会 顺利 通过 , 但 其 实 它 并 没有 连接 




















到 互联 网 。 

















EasyMock 有 3 种 不 同 的 Mock 对 象 ,分 别 是 Default Mock 对 象 Nice Mock 对 象 和 Strict Mock 
对 象 。 上 面 使 用 的 是 默认 的 Mock 对 象 ， 但 有 时 你 可 能 需要 使 用 其 他 类 型 的 Mock 对 象 。 下 表 是 




















对 3 种 Mock 对 象 的 比较 。 
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Mock 对 象 类 型 非 预期 方法 调用 方法 调用 顺序 API 方法 
Default 不 允许 不 强制 mock 
Nice 人 允许 不 强制 niceMock 
Strict 不 允许 强制 strictMock 











Nice Mock 对 象 也 会 为 所 有 非 mock 方 法 返回 默认 值 ， 比 如 @、nul1 、false 等 。 


4.4.4 Mockito 


Mockito 最 早 是 EasyMock 的 一 个 分 支 ， 它 们 的 概念 和 术语 类 似 。 不 过 ,与 EasyMock 相 比 ， 
Mockito 的 语法 更 简单 ， 且 扩展 功能 丰富 ， 其 受 欢 迎 程度 已 经 超越 了 EasyMock。 





MenuCreatorTestMockito.java 





23 @Test 

24 public void WhenAMenuIsCreated ThenDailySpecialServiceIsCalled() { 
25 //% HEA: 创建 Mock 对 象 

26 DailySpecialService mockService = 

27 Mockito.mock(DailySpecialService.class); 

28 

29 // 步 又 2: 设置 预期 行为 

30 List«String» specials = new ArrayList<>(); 

31 Mockito.when(mockService.getSpecials()).thenReturn(specials); 
32 

33 // 3 3& 3: 注入 Mock 对 象 

34 MenuCreator menuCreator - new MenuCreator(mockService); 

35 

36 // 步 骤 4: 调用 测试 对 象 

37 menuCreator .getTodaysMenu( ) ; 

38 

39 // 步 又 5: 验证 

40 Mockito.verify(mockService, Mockito.times(1)); 

41 } 








如 果 你 认真 读 过 EasyMock 部 分 的 代码 ， 应 该 对 上 面 这 段 代 码 很 熟悉 。 参 考 前 面 讲 的 5 个 步 
又 ， 以 上 代码 中 ，Mocktio.mock() 方 法 对 应 步骤 (1)，Mocktio.when( ) 方 法 对 应 步骤 (2)。 我 们 希 
A Mock 对 象 在 被 调用 时 返回 菜单 〈 这 里 是 一 个 空 列表 )。 就 像 前 面 所 讲 的 ， 步 又 (3)、 步 又 (4) 和 
使 用 何 种 测试 模拟 框架 无 关 ， 当 改 用 Mockito 时 , 它们 保持 不 变 。 最 后 , Moc 使 用 ktio.verify() 
方法 判断 Mock 对 象 的 行为 是 否 符合 预期 Mockito.times(1) 方 法 指明 Mock 方 法 只 调用 一 次 ”。 
再 次 重申 ， 进 行 这 次 测试 时 ， 我 们 其 实 并 未 真正 查询 Web 服务 。 





















































(QD 实际 上 ， 默 认 情况 下 ，Mock 方 法 也 只 调用 一 次 ， 所 以 我 们 可 以 将 其 省 略 。 
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过 向 Mock ( Class、Answer ) 方法 传人 以 下 常量 ， 你 可 以 控制 Mock 的 行为 。 


行 A 





描 xk 





CALLS_REAL_METHODS 
RETURNS_DEEP_STUBS 
RETURNS_DEFAULTS 
RETURNS_MOCKS 
RETURNS_SELF 


RETURNS_SMART_NULLS 


Mockito 还 有 一 些 注解 ， 


不 进行 任何 


隐 式 模拟 











人 允许 连续 mock 调用 ， 比 如 mockEmployee. getManager() .getName() 


默认 行为 。 











Mock ZR [n 








null, Z, 0% 





类 似 于 RETURNS. DEFAULTS, " 由 会 委托 返回 另 一 个 Mock 














返回 Mock 


返回 一 个 





不 需要 行为 验证 。 代 码 如 下 所 示 。 


43 
44 
45 
46 
47 
48 
49 
50 
ot 
52 
53 
54 
55 
56 
oT 
58 


MenuCreatorTestMockito.java 











身 。 对 使 











“增强 型 ”nu 


1 











] 建 造 者 模式 创建 的 对 象 有 








] 





， 并 且 不 会 抛 出 NullPointerException 


用 于 简化 桩 件 〈stub ) 的 创建 工作 。 桩 件 和 拟 件 (mock ) 不 同 ， 它 





@Mock 


private DailySpecialService mockDailySpecialService; 


@Test 


public void menuCreatorCanBeReused() { 


MockitoAnnotations.initMocks(this); 


MenuCreator menuCreator - new MenuCreator(mockDailySpecialService); 


try { 


menuCreator .getTodaysMenu( ) ; 


menuCreator .getTodaysMenu( ) ; 


} catch (Exception e) { 


e.printStackTrace(); 


Assert. fail("Menu creators should be reusable!"); 


} 








这 里 ， 我 们 不 关注 DailySpecialService 的 行为 ， 而 只 需 创建 一 个 桩 件 ， 这 样 在 单元 测试 
HEJ, MenuCreator 就 不 会 发 起 HTTP 调用 了 。@Mock 注解 创建 了 一 个 好 的 桩 件 ( 比如 RETURNS. 
DEFAULTS )， 可 以 返回 合适 的 默认 值 。 


极 少数 情况 下 ,你 可 能 需要 用 一 个 测试 替身 来 调用 一 些 真实 方法 和 桩 方法 。 为 此 ,你 可 以 使 
“ 漠 慎 使 用 侦 件 C spy ), 


用 espy 注解 。 请 注意 ， 
例如 在 处 理 遗 留 代码 时 ， 不 应 将 部 分 模拟 应 用 于 全 新 的 、 测 试 驱 动 及 设计 良好 的 代码 。” 


官方 文档 提醒 我 们 要 尽量 





避免 过 度 使 用 该 注解 : 
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4.4.5 PowerMock 


测试 期 间 ， 如 果 你 陷入 困境 ， 需 要 模拟 静态 方法 的 行为 ， 可 以 考虑 使 用 PowerMock 工具 。 
它 建立 在 EasyMock 和 Mockito 的 基础 之 上 ， 并 添加 了 其 他 一 些 功能 。 


使 用 EasyMock 为 方法 建 桩 如 下 所 示 。 








Ss 





DailySpecialServiceTestPowerMock.java 











23 @Test 

24 public void mockStaticWithEasyMock() throws Exception { 

25 PowerMock .mockStatic(DailySpecialService.class); 

26 EasyMock.expect(DailySpecialService.isServiceAvailable()) 

27 .andReturn(true); 

28 PowerMock.replay(DailySpecialService.class); 

29 

30 boolean available - DailySpecialService.isServiceAvailable(); 
31 assertTrue(available); 

32 } 





同样 的 测试 使 用 Mockito 实现 ， 代 码 如 下 。 


DailySpecialServiceTestPowerMock.java 





34 @Test 

35 public void mockStaticWithMockito() throws Exception { 

36 PowerMockito.mockStatic(DailySpecialService.class); 

37 Mockito.when(DailySpecialService. isServiceAvailable()).thenReturn(true); 
38 

39 boolean available = DailySpecialService. isServiceAvailable(); 

40 assertTrue(available); 

41 } 
































id 
































不 错 ， 这 两 个 测试 不 是 太 新 颖 。 通 常 ， 只 有 当 你 用 到 第 三 方 代码 或 遗留 代码 ,并 且 无 法 通过 
重 构 避 免 调 用 静态 方法 时 ， 才 会 使 用 PowerMock。 上 比如， 设想 这 样 一 种 情况 〈 伪 代 码 ): 一 个 
Web 控制 器 要 和 第 三 方 会 话 上 下 文 (session context ) 打交道 。 











public class MyWebController { 
public void getHomePage() { 
WebApplicationSession.setVariable("user", new User()); 


JA utes 


public class MyWebControllerTest { 





GTest 
public void someTest() { 
MyWebController controller = new MyWebController(); 
controller.getHomePage(); 
WA s os 
j 
j 


为 了 测试 控制 器 ， 可 以 对 WebApplicationSession 做 静态 建 桩 处 理 ， 这 也 会 简化 对 控制 器 
的 测试 工作 。 


此 外 , PowerMock 还 可 以 模拟 final 方法 和 类 , 以 及 private 方法。 更 多 细节 , 可 参阅 PowerMock 


wiki”. 
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显而易见 ，Java 测试 领域 广阔 且 丰 富 多 样 。 实 际 上 ,还 有 其 他 一 些 框架 这 里 没有 提 到 ， 或 许 
它们 更 符合 你 的 需要 。 尽 管 如 此 ，JUnit 还 是 占据 主导 地 位 ， 它 是 现 有 应 用 程序 中 最 常用 的 测试 
框架 。 以 前 TestNG 提供 的 功能 比 JUnit 多 , 但 现在 两 个 框架 已 经 不 分 伯仲 了 。 就 测试 替身 ( 拟 件 、 
桩 件 、 侦 件 ) 来 说 ，Mockito 是 个 不 错 的 选择 ，EasyMock 也 不 差 ， 只 是 稍微 有 点 宛 长 。 


这 些 框架 和 构建 工具 也 能 很 好 地 集成 在 一 起 , 使 得 执行 测试 成 为 构建 过 程 的 一 个 步 又 。 对 于 
维护 良好 的 代码 ， 你 可 以 从 源 代 码 版 本 控制 系统 获取 代码 ， 然 后 使 用 Maven, Gradle 或 Ant 运行 
测试 。 如 果 你 面 对 的 是 遗留 代码 , 那么 它们 很 可 能 没有 经 过 测试 , 或 者 尽管 好 心 的 开发 者 已 经 尽 
力 引 入 测试 ,但 测试 仍然 不 完整 。 如 果 你 想 添加 自己 的 测试 ，PowerMock 会 非常 有 用 ,借助 它 ， 
你 可 以 找 出 应 用 程序 中 有 问题 的 部 分 ， 然 后 进行 修改 。 
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4.6.1 综合 测试 


Martin Fowler. Mocks Aren't Stubs, 2007-01-02. 
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Spring 


























在 Java KA, Spring 也 许 是 最 知名 的 工具 集 了 。 EU, Spring 只 是 一 个 便于 连接 应 用 程序 
组 件 的 工具 ， 后 来 逐渐 发 展 成 各 种 框架 的 集合 ， 其 包含 的 框架 可 用 于 构建 Web 应 用 程序 、 访 问 
数据 、 快 速 应 用 程序 开发 、 微 服务 配置 、 移 动 开 发 等 。 


Spring Core 是 所 有 Spring 工具 的 核心 。 本 章 先 讲 Spring Core 基础 知识 ， 然 后 介绍 一 个 著名 
的 现代 Spring 框架 Spring Boot。 当 然 ，Spring 工具 包 还 有 很 多 工具 。 本 章 后 半 部 分 还 会 介绍 
Spring JDBC 和 Spring MVC。 



































5.1 Spring Core 


5.1.1. 依赖 注入 


术语 “依赖 注入 ”( DI) 是 个 用 复杂 单词 描述 简单 概念 的 典型 例子 。Spring 文档 对 “依赖 注 
入 ”的 解释 如 下 。 


依赖 注入 是 对 参 定 义 其 依赖 的 过 程 ， 这 里 的 “依赖 ” 指 该 对 象 使 用 的 其 他 对 象 ， 这 
个 过 程 只 能 通过 构造 函数 参数 、 工 厂 方法 参数 ， 或 者 为 对 象 实例 ( 由 工厂 方法 构建 或 返 
回 ) 设置 的 属性 来 实现 。 


有 点 绕 ， 是 不 是 ”在 任何 应 用 程序 中 ， 一 个 对 象 依赖 于 其 他 对 象 才能 正常 工作 。 比 如 ， 在 
IScream 应 用 程序 中 ，Application 要 用 到 DailySpecialService。 这 时 ，Application 便 依 赖 
DailySpecialService。 到 目前 为 止 , 我 们 一 直 是 在 代码 中 显 式 创建 服务 。 而 Spring 能 够 自动 创 
££ (或 注入 ) 依赖 。 





























o 这 到 底 是 什么 ? 
Spring Core 管理 着 应 用 程序 中 所 有 依赖 其 他 对 象 的 对 象 。 在 Spring 中 ， 你 不 必 
在 代码 中 手动 创建 和 配置 对 象 ，Spring 会 在 运行 时 自动 帮 我 们 完成 。 





凡事 有 利 必 有 疾 。 开 发 者 很 可 能 因此 而 过 度 依赖 Spring 来 创建 复杂 的 依赖 树 。 而 且 , 由 于 大 
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部 分 依赖 是 在 代码 外 部 管理 的 ， 所 以 有 时 应 用 程序 更 难以 理解 。 最 后 还 要 注意 , 依赖 注入 错误 往 
往 到 运行 时 才 会 显露 。 不 借助 编译 器 ， 很 难 搞 清楚 某 个 组 件 出 现 注 入 错误 的 原因 。 


1. XML 和 注解 


和 许多 Java 框架 一 样 ，Spring 刚 诞 生 时 也 使 用 XML 进行 配置 。 这 个 选择 有 隐患 。 尽 管 有 一 
些 措施 可 以 保证 XML 文档 的 合法 性 ， 但 是 编译 期 间 还 是 会 无 法 检查 到 某 些 地 方 ， 这 导致 许多 精 
糕 的 运行 时 错误 产生 。 而 且 ，XML 文档 有 可 能 变 得 见长 、 繁 杂 ， 且 难以 阅读 。 为 此 ，Spring 3 
引入 了 注解 , 不 使 用 XML 也 可 以 配置 应 用 程序 。 注解 不 会 造成 编译 时 错误 , 但 可 能 引发 一 些 ( 并 
非 所 有 ) 运行 时 错误 ,而 且 有 助 于 指明 各 个 类 在 代码 中 的 用 法 。 下 面 展示 XML 和 注解 两 种 风格 ， 
但 请 注意 ， 它 们 并 非 互 不 相 容 。 你 可 以 根据 不 同 用 途 同 时 使 用 XML 和 注解 。 


2. 使 用 XML 
为 了 使 用 Spring, ， 需 要 修改 [Scream 应 用 程序 ， 我们 先 创建 一 个 依赖 DailySpecialService 


类 的 DailySpecialPrinter 2k, 





































































































DailySpecialPrinter.java 








1 package com.letstalkdata.iscream; 

2 

3 import com.letstalkdata.iscream.service.DailySpecialService; 

4 

5 import java.util.List; 

6 

7 public class DailySpecialPrinter { 

8 

9 private DailySpecialService dailySpecialService; 

0 

1 public DailySpecialService getDailySpecialService() { 

2 return dailySpecialService; 

3 j 

4 

5 public void setDailySpecialService(DailySpecialService dailySpecialService) { 
6 this.dailySpecialService - dailySpecialService; 

T j 

8 

9 public void printSpecials() { 
20 List«String» dailySpecials - dailySpecialService.getSpecials(); 
21 
22 System.out.println("Today's specials are:"); 
23 dailySpecials.forEach(s -> System.out.println(" - " + s)); 
24 } 


N 
ol 
we 
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Q Java È: getter 和 setter 方法 

在 大 多 数 Java 代码 中 ， 带 有 公共 访问 方法 的 私有 类 属性 无 处 不 在 。 对 此 ， 官 方 
解释 是 : 使 用 getter 和 setter 方法 ， 你 不 必 担 心底 层 实 现 是 否 发 生 改 变 。 但 实际 
上 ，getter 和 setter 方法 只 执行 “获取 ”(get ) 和 “设置 ”( set ),。 ERRE, € 
们 让 类 变 得 易 变 。 
那 为 何 还 要 创建 它们 呢 ? 因为 许多 框架 都 要 使 用 它们 ， 比 如 Spring XML 使 用 
setter 方法 注入 依赖 (当然 ， 也 可 以 使 用 构造 函数 来 注入 依赖 ， 但 这 对 开发 者 来 
说 更 麻烦 )。 还 有 很 多 框架 使 用 getter 和 setter 方法 ,但 是 有 些 框架 在 这 两 个 访问 
方法 不 可 用 时 会 自动 查找 类 属性 














下 面 我 们 使 用 XML 把 Spring 添加 到 项 目 中 ， 首 先 创建 一 个 XML 文件 ， 按 照 惯 例 将 其 命名 
为 applicationContext.xml。 如 果 使 用 的 是 Maven 或 Gradle, ， 那 么 你 应 该 把 这 个 文件 放 在 
src/main/resources 文件 夹 中 。applicationContext.xml 文件 定义 了 一 些 bean， 可 以 把 它们 看 作 应 用 














程序 的 组 件 。 





applicationContext.xml 











1 <?xml version="1.0" encoding="UTF-8"?> 

2 «beans xmlns="http: //www.springframework.org/schema/beans" 

3 xmlns:xsi-"http://www.w3.0org/2004/XMLSchema- instance" 

4 xsi:schemaLocation="http: //www.springframework.org/schema/beans 

5 http: //www.springframework .org/schema/beans/spr ing—beans.xsd"> 

6 

7 <bean id="dailySpecialServiceBean" 

8 class="com. letstalkdata.iscream.service.DailySpecialService" /> 
9 
10 <bean id="dailySpecialPrinter" 
11 class-"com.letstalkdata.iscream.DailySpecialPrinter"» 
12 «property name="dailySpecialService" ref-"dailySpecialServiceBean"/» 
13 </bean> 
14 </beans> 





O 更 多 内 容 : JavaBean 

一 个 JavaBean 就 是 一 个 Java 对 象 ， 它 满足 一 些 特定 要 求 ， 其 目的 是 在 应 用 程序 
内 部 或 者 应 用 程序 之 间 实 现 复 用 ,一 个 类 必须 满足 如 下 条 件 , 才 能 成 为 JavaBean。 
口 有 一 个 公开 且 不 带 参数 的 构造 函数 。 
口 通过 一 系列 getter 和 setter 方 法 访问 其 属性 。 
O 可 序列 化 ( 即 实现 了 java.io.Serializable 接口 )。 
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有 些 框 架 需要 使 用 JavaBeans, 或 者 至 少 在 JavaBeans 的 协助 下 才 有 最 佳 表 现 。 
尽管 Spring 也 将 其 托管 对 象 称 为 bean, 但 是 这 些 bean 可 能 并 不 完全 满足 JavaBean 
的 要 求 ， 就 这 一 点 而 言 ，Spring bean 可 能 并 非 真 正 意 义 上 的 JavaBean. 


上 面 的 XML 文件 中 , 我 们 定义 的 第 一 个 bean 是 DailySpecialService 服务 ,其 中 id 可 以 
随意 指定 ， 而 class 指 的 是 你 想 创 建 的 对 象 的 类 型 。 








applicationContext.xml 





T «bean id="dailySpecialServiceBean" 


class-"com.letstalkdata.iscream.service.DailySpecialService" /» 











接着 ， 我 们 定义 了 一 个 Printer， 它 包含 一 个 property (属性 )， 其 中 name (属性 名 ) 必须 
与 实际 的 Java 类 名 一 致 ， 即 eae A ref 指 的 是 XML 文件 的 另 一 个 bean, HI 


dailySpecialServiceBean。 





TH 


applicationContext.xml 





10 <bean id="dailySpecialPrinter" 

11 class="com. letstalkdata.iscream.DailySpecialPrinter"> 

12 «property name="dailySpecialService" ref-"dailySpecialServiceBean"/» 
13 «/bean» 























Spring 配置 应 用 程序 的 最 后 一 步 是 在 main 方法 中 获取 ApplicationContext 的 引用 ,并 且 使 
用 上 下 文 创建 Printer， 这 个 过 程 称 为 “引导 ”( bootstrapping )。 








Application.java 





package com.letstalkdata.iscream; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplicationContext; 


public class Application { 


private static final String CONTEXT PATH 
- "applicationContext.xml"; 


public static void main(String[] args) { 
ApplicationContext ctx = 


new ClassPathXmlApplicationContext(CONTEXT. PATH); 
DailySpecialPrinter printer - ctx.getBean(DailySpecialPrinter.class); 
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17 System.out.println("Starting store! \n\n==============\n"); 
18 printer.printSpecials(); 

19 } 

20 } 














在 应 用 程序 中 使 用 Spring 的 getBean 方法 往往 不 是 明智 之 举 ， 你 应 该 配置 Spring, fi HH 
动 创建 对 象 。 如 果 把 应 用 程序 的 依赖 想 成 一 棵 树 ， 那么 我 们 还 要 想 办 法 创建 根 对 象 。 因 此 ,通常 
的 做 法 是 引导 时 在 main 中 调用 一 次 getBean 方法 。 


现在 ， 如 果 运 行 应 用 程序 ， 你 会 发 现 尽管 从 未 显 式 创建 过 DailySpecialService 类 ,应 用 
旦 序 仍然 能 够 正常 运行 。 
3. 使 用 注解 


与 使 用 XML 方法 时 一 样 ， 我 们 先 创建 一 个 依赖 Dai lySpecialService HY Dai lySpecialPrinter 
类 。 这 次 我 们 不 用 applicationContext.xml, MIE @Component Fil @Autowired 注解 。 在 一 个 类 前 
添加 eComponent 注解 ，Spring 就 能 检测 到 这 个 类 。@Autowired 注解 用 于 指明 你 想 让 Spring 注入 
的 方法 或 字段 。 使 用 了 注解 的 Printer 如 下 。 




















= 





DailySpecialPrinter.java 





package com. letstalkdata.iscream; 

import com. letstalkdata.iscream.service.DailySpecialService; 
import org.springframework.beans. factory.annotation.Autowired; 
import org.springframework.stereotype.Component; 


import java.util.List; 


@Component 


public class DailySpecialPrinter { 


private DailySpecialService dailySpecialService; 


@Autowired 


public DailySpecialPrinter(DailySpecialService dailySpecialService) { 





this.dailySpecialService = dailySpecialService; 
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public void printSpecials() { 


N 
© 


List«String» dailySpecials = dailySpecialService.getSpecials(); 


N N 
N e 


System.out.println("Today's specials are:"); 


N 
CD 


dailySpecials.forEach(s -> System.out.println(" - " + s)); 
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@Autowired 注解 也 可 以 用 在 setter WIA ZAM. 


private DailySpecialService dailySpecialService; 


@Autowired 
public void setDailySpecialService(DailySpecialService service) { 
this.dailySpecialService = service; 


} 
或 者 ， 用 在 字段 之 前 。 
@Autowired 


private DailySpecialService dailySpecialService; 


Spring 使 用 指南 建议 我 们 使 用 构造 函数 注入 必要 的 依赖 , 而 使 用 setter 方 法 注入 可 选 的 依赖 。 
BBA, 字段 注 和 人 是 什么 情况 ?字段 注入 存在 一 些 问题 。 注入 字段 时 , 你 需要 使 用 Spring 创建 一 个 
类 。 Bat, 不管 做 什么 都 得 看 时 机 、 分 场合 ， 有 时 候 保持 字段 注入 属性 的 简洁 性 很 重要 。 但 有 一 
点 要 记 住 ， 过 度 依赖 说 明 设 计 有 问题 。 更 多 相关 讨论 ， 请 阅读 文章 “Why field injection is evil” o 

由 于 我 们 的 目标 是 让 Spring 注入 DailySpecialService ， 因 此 需要 先 让 Spring“ 看 见 ” 它 。 
前 面 提 过 ， 这 可 以 使 用 ecomponent 注解 来 实现 。 不 过 ， 我 更 喜欢 使 用 eservice 注解 。 二 者 在 功 
能 上 并 无 二 致 ， 但 是 eservice 属于 类 的 语义 标记 ， 与 eGComponent 相 比 更 明确 。 





























@Service 

public class DailySpecialService { 
// 简 洁 起 见 ， 省 略 类 体 

j 


最 后 需要 调整 Application 类 。 和 使 用 XML 方法 时 一 样 ， 我 们 需要 引导 Spring, 但 这 次 我 
们 使 用 一 个 不 同 的 ApplicationContext: AnnotationConfigApplicationContext (在 Spring 
中 你 要 习惯 长 长 的 类 名 )。 此 外 , 我 们 还 要 使 用 ecomponentScan 对 类 做 注解 ,告诉 Spring 从 这 个 
类 开始 ， 沿 着 包 向 下 递归 查找 ， 找 到 Spring 能 够 实例 化 的 类 ， 比 如 带 有 ecomponent 或 @Service 
注解 (或 者 其 他 Spring 组 件 注解 ) 的 类 。 








Application.java 





package com.letstalkdata.iscream; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.annotation.AnnotationConfigApplicationContext; 
import org.springframework.context.annotation.ComponentScan; 
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@ComponentScan 
public class Application { 


public static void main(String[] args) { 
ApplicationContext ctx = 
new AnnotationConfigApplicationContext(Application.class); 
DailySpecialPrinter printer - ctx.getBean(DailySpecialPrinter.class); 


System.out.println("Starting store! \n\n==============\n"); 
printer.printSpecials(); 
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} 























至 此 ， | 于 应 用 程序 了， 虽然 我 们 并 未 显 式 创建 过 DailySpecialService 类 , 但 
是 程序 仍然 能 能 下 运行 。 























5.1.2 属性 


通常 应 该 将 应 用 程序 的 某 些 值 放 在 代码 之 外 。 这 会 让 应 用 程序 的 配置 和 部 署 变 得 更 容易 , JU 
其 当 你 需要 维护 同一 个 应 用 程序 的 多 个 实例 并 且 它 们 的 配置 各 不 相同 时 更 应 如 此 。 

假设 我 们 的 应 用 程序 要 在 UAT( 用 户 验 收 测试 ) 环境 中 运行 ， 这 个 环境 连接 到 了 一 个 测试 
专用 的 Web 服务 ， 同 时 所 维护 的 生产 应 用 程序 又 指向 生产 Web 服务 。 在 这 种 情况 下， 我 们 就 不 
能 再 把 URL 硬 编 码 到 DailySpecialService 中 了 。 


在 文件 系统 某 个 目录 下 ， 创 建 以 下 文件 。 





















































application.uat.properties 





specials.url = http://www.mocky.io/v2/59040106210000038034 f66dc 





application.prod.properties 





specials.url - http://www.example.com/some-prod-url 





O 更 多 内 容 : properties 文件 
以 .properties 为 扩展 名 的 纯 文 本 文件 通常 用 于 配置 那些 需要 进行 少许 设置 的 Java 
应 用 程序 或 框架 。 这 些 文 件 包 UNE NU 大 部 分 解析 器 都 能 智能 识别 出 字 
符 串 、 数 字 和 布尔 值 。 按 照 惯 例 , 用 实心 句点 分 隔 各 个 词 。 比 如 ,一 个 properties 
文件 中 可 能 包含 app.directory.input. app.directory .output、 app.db.username、 
app.db.password FAR. 
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ETE, 我们 需要 告诉 Spring 如 何 访问 .properties 文件 。 为 此 ， 需 要 在 Application 类 上 方 
添加 @PropertySource 注解 。( 如 果 用 的 是 XML, 则 需要 在 XML 文件 中 添加 PropertyPlaceholder 


Configurer, ) 

















Application.java 





8 @ComponentScan 
9 @PropertySource("file:${propPath}/application.${env}.properties") 
10 public class Application { 





注意 , 我 们 的 应 用 程序 要 在 多 种 环境 中 运行 。 为 了 避免 重复 编译 代码 , 我 们 可 以 让 应 用 程序 
动态 访问 其 属性 。Spring 支持 表达 式 语言 ， 允 许字 符 串 插值 操作 ,使 得 我 们 可 以 动态 调整 文件 路 
径 的 某 些 部 分 。Spring 会 查找 Java 系统 属性 或 环境 变量 以 获取 propPath 和 env WE, 并且 替换 
文件 路 径 中 的 ${propPath} 和 ${env}。 然 后 ,@PropertySource 会 读 取 文 件 , 并 将 其 加 载 到 Spring 
上 下 文中 , 使 得 应 用 程序 可 以 使 用 这 些 属性 。 这 非常 有 用 ， 因 为 你 可 以 动态 配置 应 用 程序 ， 而 无 
须 重新 编译 它 。 


当 使 用 应 用 程序 属性 时 ， 你 可 以 使 用 evalue 注解 ， 或 者 直接 在 XML 文件 的 bean 属性 
(property) 中 引用 它们 。 下 面 的 代码 展示 了 如 何 访问 DailySpecialService 中 的 URL. 
















































































DailySpecialService.java 





23 private String specialsUrl; 

24 

25 public DailySpecialService(@Value("${specials.url}") String specialsUrl) { 
26 this.specialsUrl = specialsUrl; 

27 } 








同样 , 我 们 使 用 了 Spring 表达 式 语言 引用 要 使 用 的 具体 属性 。 正 如 可 以 通过 字段 、 构 造 函 数 
或 setter 方 法 注入 对 象 一 样 ， 属 性 也 可 以 。 适 用 的 规则 也 一 样 ， 通常， 最 好 把 evalue 注解 放 到 构 
造 函 数 中 。 


设置 好 propPath 和 env 变量 后 ， 就 可 以 运行 应 用 程序 了 。 对 于 测试 ， 最 简单 的 方法 是 通过 
配置 IDE 来 传人 Java 系统 (或 者 “VM”) 属性 ， 比 如 -Denv=uat。 











T 






























































o EZAR: 系统 属性 
事实 上 ,我 们 可 以 在 JVM 启动 时 使 用 某 些 参数 来 配置 系统 属性 ,这 些 属性 在 JVM 
所 使 用 的 语法 是 java -Dkey = value, 其 中 key fe value 
实际 的 属性 名 和 属性 值 。 我 们 将 这 些 属 性 称 为 “系统 属性 ”或 “系统 变量 ”。 
2 性 是 由 JVM 规范 定义 的 ， 此 外 也 可 以 设置 自 定义 属性 
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5.2 Spring Boot 


为 保证 各 个 组 件 能 够 协同 工作 ，Spring 团队 做 了 大 量 出 色 的 工作 。 不过， 开发 者 似乎 总 能 把 
事情 变 复杂 ,糟糕 的 applicationContext.xml 文件 也 屡见不鲜 。 FR Spring 使 用 指南 可 以 提供 很 多 
帮助 ， 但 是 正确 配置 一 个 Spring 应 用 程序 仍 不 容易 ， 即 便 使 用 注解 ， 也 无 法 轻松 实现 。 


2014 年 ，Spring 团队 发 布 了 Spring Boot， 该 工具 有 助 于 开发 者 通过 Spring 平台 快速 开发 应 
JH. Spring Boot 遵循 “约定 优 于 配置 ”的 理念 ， 大 大 简化 了 新 Spring 应 用 程序 的 初始 搭建 和 开 
发 过 程 。 

构建 Spring Boot 应 用 程序 从 一 个 或 多 个 “starter” 开始 , 这 些 “starter” 包含 在 Maven 或 Gradle 
依赖 列表 中 ,比如 ,一 个 与 LDAP 服务 器 通信 的 Web 应 用 程序 会 用 到 spring-boot-starter-web 
和 spring-boot-starter-data-1dap。 你 可 以 在 Spring Boot 的 GitHub 仓库 中 找到 完整 的 starter 
NR 






































5.2.1 运行 Spring Boot 应 用 程序 


类 似 于 Java 程序 ，Spring Boot 程序 的 人 口 是 一 个 包含 main 方法 的 类 。 不 过 ， 它 需要 一 些 特 
殊 配 置 才能 通过 Spring Boot 运行 起 来 。 





首先 , 在 类 前 添加 @SpringBootApplication 注解 。 这 是 一 个 快捷 注解 ,由 econfiguration、 
@EnableAutoConfiguration 和 @ComponentScan 组 成 。 前 面 提 过 @componentScan， 其 他 两 个 注 
解 基于 以 下 内 容 配置 应 用 程序 。 


a 添加 到 这 个 类 的 设置 (econfiguration ). 
a 类 路 径 中 的 内 容 ( @EnableAutoConfiguration )。 


通常 ，main 方法 非常 简单 。 比 如 ， 将 类 命名 为 Application.java， 如 下 所 示 。 













































































public static void main(String[] args) throws Exception { 





SpringApplication.run(Application.class, args); 


j 
Hp, run ) 静 态 方法 负责 启动 相关 工作 。 


Spring Boot 项 目 既 可 以 从 IDE 启动 ， 也 可 以 先 使 用 Maven 或 Gradle 编译 成 .jar 文件 再 运行 。 
此 外 ， 我 们 也 可 以 在 命令 行 中 使 用 mvn spring-boot:run 和 gradle bootRun 命令 来 编译 和 运行 
应 用 程序 。 























(D https://github.com/spring-projects/spring-boot/tree/master/spring-boot-project/spring-boot-starters 
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从 前 面 的 介绍 中 ， 可 以 看 出 Spring 在 简化 配置 方面 做 了 很 多 努力 。Spring Boot 把 多 个 配置 





概念 规范 化 为 “配置 文件 ”( profile )。 一 个 应 用 程序 运行 时 会 有 一 个 或 多 个 配置 文件 起 作用 ,使 
得 在 不 同 运行 时 环境 中 混合 和 匹配 配置 很 容易 。 


Spring Boot 把 与 环境 无 关 的 属性 放 到 application.properties 或 application.yml 中 而 将 不 同 环 
境 的 特有 配置 放 到 application-foo.properties 或 application-foo.yml 文件 中 , 其 中 foo 指 的 是 具体 环 
境 。 当 使 用 yml 文件 时 ， 属 性 名 是 分 开 的 ， 比 如 spring.foo.bar=baz 会 变 成 : 

















Spring: 
foo: 
bar: baz 














以 前 面 的 属性 为 例 ， 编 写 以 下 配置 文件 ， 在 不 同 的 [Scream Web 服务 间 进 行 切换 。 




















application.yml 





spring: 
profiles: 
active: uat 





application-uat.yml 





specials: 


url: http://www.mocky.io/v2/59040106210000038034 f66dc 





application-prod.yml 





specials: 


url: http://www.example.com/some-prod-url 





上 面 的 配置 把 默认 配置 文件 设 为 uat。 你 也 可 以 使 用 Java 系统 变量 spring.profiles.active 























将 其 覆盖 ， 例如 通过 java -jar -Dspring.profiles.active-prod my-app.jar 或 环境 变量 





SPRING. PROFILES. ACTIVE 来 实现 。 习 





EXE, PA Spring Boot 


ra 








属性 都 可 以 用 这 两 种 方法 来 覆盖 。 








前 面 提 过 ， 多 个 配置 文件 可 以 混合 在 一 起 ， 只 要 在 各 个 配置 文件 名 称 之 间 加 上 逗号 进行 分 隔 就 


行 了 。 


»»l 超前 警告 : Spring Cloud 





Config 


如 果 你 运行 的 是 分 布 式 软件 或 者 需要 支持 多 个 环境 ,应 用 程序 配置 文件 可 能 变 得 
+ KK. Ash, Spring 提出 了 Spring Cloud Config 解决 方案 ， 它 使 得 应 用 程序 
可 以 通过 查询 Web 服务 来 确定 属性 。 默 认 情况 下 ， 这 些 属 性 存储 在 Git 仓 库 中 ， 
Spring Cloud Server 会 克隆 它们 ， 并 且 发 送 给 发 来 请 求 的 应 用 程序 。 
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5.3 小 结 


本 章 只 介绍 了 Spring 框架 的 皮毛 ，Spring 的 使 用 方式 多 种 多 样 , 所 以 很 难 给 出 一 些 普遍 适用 
的 建议 。 不 过 , 我 们 至 少 可 以 记 住 ，Spring Core 的 目标 是 在 运行 时 把 应 用 程序 同 所 有 配置 适当 的 
依赖 项 组 合 在 一 起 。 前 面 提 过 ，Spring 工具 集 很 流行 ， 讲 解 后 面 的 内 容 时 ， 我 们 会 再 次 提 到 和 它 。 


Spring Boot 是 搭建 Spring 应 用 程序 的 新 方法 ， 它 使 开发 者 有 更 多 的 时 间 编 写 代 码 ， 大 大 减 
少 了 配置 所 花 的 时 间 。 本 章 代码 中 有 相应 的 例子 。 更 多 相关 内 容 ， 第 6 章 讨论 Web 框架 时 将 深 
入 讲解 。 
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第 6 章 


Web 应 用 程序 框 染 








在 企业 环境 中 ，Java 最 常用 于 Web 开发 。1999 年 ，Sun 公司 推出 了 J2EE (Java 2 Platform, 
Enterprise Edition，Java2 平台 企业 版 )， 它 为 开发 者 提供 了 许多 API， 使 得 使 用 Java 进行 Web FF 
发 变 得 可 行 。 从 那 以 后 ， 出 现 了 数 十 种 Web 开发 框架 ， 起 落 浮 沉 。 如 今 仍 有 大 量 Web 开发 框架 
可 供 选 择 ， 一 一 介绍 它们 绝 非 易 事 ， 所 以 这 里 只 介绍 几 个 最 流行 的 框架 。 


Q Spring MVC: 截至 目前 ， 在 众多 Web 开发 框架 中 ，Spring MVC 框架 占据 着 主导 地 位 。 
它 在 Spring Core ( 前面 讲 过 ) 的 基础 上 发 展 而 来 ， 提 供 了 构建 控制 器 的 功能 ， 这 些 控制 

邮 器 可 以 实现 业务 模型 和 HTML 视图 的 交互 。 

Q Spring Boot: 前 面 介绍 了 使 用 Spring Boot 创建 控制 台 应 用 程序 的 方法 ， 它 也 可 以 用 作 

Spring MVC 的 封装 器 ， 进 一 步 简化 Web 开发 过 程 。 

口 Java Server Faces (JSF ): JSF 框架 建立 在 可 复 用 的 UI 组 件 之 上 ， 这 些 组 件 可 以 很 容易 
地 链接 到 数据 和 事件 处 理 程序 。 它 抽象 了 大 部 分 HIML CSS 和 JavaScript， 并 且 能 够 与 
AJAX 很 好 地 集成 。 

O Vaadin: Vaadin 比 JSF 更 进一步 , 它 完全 抽象 了 所 有 客户 端 代码 和 Web 应 用 程序 的 请 求 - 


响应 周期 。 











I« 落后 警告 :过 时 框架 

几 年 前 ， 我 接手 过 一 个 Web 应 用 程序 ， 它 所 采用 的 框架 在 2008 年 就 已 “ 寿 终 正 
究 ” 了 。 幸 好 后 来 我 找到 了 一 个 内 部 应 用 程序 ， 才 解决 了 一 些 重大 的 安全 问题 。 
对 于 这 样 的 框架 ， 像 样 的 文档 也 很 难 找到 。 然 而 这 样 的 例子 在 企业 级 Java 环境 

中 并 不 鲜 见 。 在 Java 历史 上 ， 有 很 多 Web 框架 兴起 又 消亡 。 

如 果 你 正 被 过 时 框架 困扰 ， 下 面 几 种 方法 可 以 帮 到 你 。 

O 找 出 模式 : 添加 新 特征 时 ， 尽 量 从 应 用 程序 中 寻找 已 有 的 相似 特征 ， 然 后 进 

行 模仿 。 

O 逛 论坛 : 2000 年 初 , KE Web 论坛 兴起 , 很 多 活跃 至 今 。 提 高 网 络 搜索 技巧 ， 

你 会 有 所 收获 。 多 试 试 网 站 中 的 “更 多 内 容 ”。 








56 €$ 63x Web 应 用 程序 框架 





口 寻求 帮助 : 多 请 教 团队 中 的 前 莫 ， 他 们 中 很 可 能 有 人 曾经 用 过 你 用 的 那个 杠 
架 ， 或 许可 以 帮 你 解决 你 遇 到 的 问题 。 


6.1 Java EE Web API 


使 用 Java Web 框架 时 , 通常 你 并 不 需要 直接 和 Java EE 的 底层 API 打交道, 但 是 你 仍 需 要 了 
解 一 些 概念 。 











6.1.1 请 求 和 响应 


进入 框架 的 请 求 就 是 HttpServletRequest ， 经 由 它 可 以 访问 会 话 、cookies 、 人 参数 、 表 单数 
据 等 。 返 回 给 客户 的 响应 是 HttpServletResponse, 我 们 可 以 修改 它 , 使 其 包含 状态 码 、 响 应 数 
据 、 头 信息 等 。 


有 时 你 需要 直接 使 用 这 些 对 象 。 此 时 , 控制 需 方 法 可 以 接收 HttpServletRequest 作为 参数 ， 
返回 HttpServletResponse。 不 过 ， 大 部 分 时 候 ， 框 架 会 蔡 你 完成 。 








6.1.2 JavaServer Pages 


JavaServer Pages (JSP) 技术 支持 动态 生成 HTML. jsp CUPRA LED en EY 
HTML 文件 类 似 。 这 些 扩 展 支 持 访问 模型 数据 和 执行 简单 的 逻辑 ( 比如 条 件 语句 和 循环 语句 )， 
以 产生 动态 内 容 。 它 们 在 服务 器 端 进行 计算 ， 并 转换 成 HTML， 发 送 给 客户 端 。 尽管 还 有 其 他 创 
建 Web 应 用 程序 视图 的 方法 ,但 是 很 多 框架 都 采用 了 ISP 技术 。 
































6.1.3 servlet 容器 


大 多 数 Java Web 应 用 程序 都 部 署 在 “servlet 容器 ”中 。servlet 容器 负责 处 理 Web 服务 器 和 
Java 应 用 程序 之 间 的 通信 。 下 一 章 会 介绍 更 多 容器 相关 内 容 , 现在 你 只 需要 知道 应 用 程序 必须 把 
自身 注册 到 容器 中 就 好 了 。 这 通常 使 用 web.xml 文件 来 实现 , 不 过 有 些 框架 支持 使 用 纯 Java 代码 
实现 。 

大 多 数 框架 的 目录 结构 如 下 。 

口 src/main/java: 应 用 程序 代码 。 
口 src/main/resources: 文本 文件 、 属 性 等 。 它 们 包含 在 类 路 径 中 ， 协 助 应 用 程序 代码 。 


口 src/main/webapp/resources: 公共 资源 ， 比 如 CSS, JavaScript, KURSE. 
口 src/main/webapp/WEB-INF: 私有 资源 ，servlet 容器 可 以 访问 它们 。 
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6.2 Spring MVC 


本 书 不 会 详细 讲解 MVC ( Model-View-Controller， 模 型 -视图 -控制 器 ) 模式 的 相关 内 容 ,， 这 
里 只 做 简单 介绍 。 模 型 指 的 是 逻辑 和 业务 对 象 , 视图 指 的 是 与 用 户 交 互 的 界面 ,控制 器 负责 把 模 
型 和 视图 绑 在 一 起 。Spring 的 MVC 框架 提供 了 一 套 以 控制 器 为 中 心 的 API， 易 于 把 请 求 转换 成 
模型 对 象 ， 以 及 把 模型 对 象 转换 成 视图 。 






























































6.2.1 ”模型 


下 面 为 IScream 公司 创建 的 一 个 简单 的 销售 点 系统 ， 工 作 人 员 可 以 处 理 冰激凌 订单 ， 并 计算 
费用 。 首 先 ， 添加 儿 个 辅助 的 领域 对 象 ( domain object )。 




















Flavor.java 

1 package com.letstalkdata.iscream.domain; 
2 

3 import java.util.Locale; 

4 

5 public enum Flavor { 

6 VANILLA, CHOCOLATE, STRAWBERRY; 

7 

8 public String toString() { 

9 return name().charAt(@) + 
10 name().substring(1).toLowerCase(Locale.getDefault()); 
11 } 
12 } 

Topping.java 

1 package com. letstalkdata.iscream.domain; 
2 

3 import java.util.Locale; 

4 

5 public enum Topping { 

6 CARAMEL , 

T CHERRY, 

8 PEANUTS, 

9 SPRINKLES; 
10 
11 public String toString() { 
12 return name().charAt(0) + 
13 name().substring(1).toLowerCase(Locale.getDefault()); 
14 } 


m 
ol 
we 
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Order.java 





package com. letstalkdata.iscream.domain; 


import java.util.ArrayList; 
import java.util.Arrays; 
import java.util.List; 


public class Order { 
private String flavor; 
private int scoops; 
private List<Topping> toppings = new ArrayList<>(); 


public Order() { 


public Order(String flavor, int scoops, Topping... toppings) { 
this. flavor = flavor; 
this.scoops = scoops; 
this.toppings = Arrays.asList(toppings); 


public String getFlavor() { 
return flavor; 


public void setFlavor(String flavor) { 
this. flavor = flavor; 


public int getScoops() { 
return scoops; 


public void setScoops(int scoops) { 
this.scoops = scoops; 


public List<Topping> getToppings() { 
return toppings; 


public void setToppings(List«Topping» toppings) { 
this.toppings = toppings; 
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44 } 

45 

46 public double getPrice() { 

47 return scoops x 1.50d + toppings.size() x 0.25d; 
48 } 

49 } 























值得 注意 的 是 ， 上 面 的 代码 中 没有 任何 部 分 将 这 些 对 象 标 识 为 Web 应 用 程序 的 一 部 分 ， 这 
是 有 意 为 之 。Spring 会 尽量 使 用 简单 Java 对 象 (POJO, Plain Old Java Object )。 





6.2.2 视图 
该 应 用 程序 有 两 个 视图 : 一 个 负责 向 雇员 显示 订单 数据 , 另 一 个 负责 返回 价格 。Spring MVC 
可 以 使 用 各 种 视图 技术 ， 而 这 里 选择 ISP 技术。 


前 面 提 过 ，.jsp 文件 类 似 于 HTML 文件 ， 可 以 使 用 HTML 的 所 有 可 用 标签 。 当 然 ， 通 过 在 
文件 项 部 添加 taglib ， 我 们 也 可 以 使 用 其 他 标签 。 大 多 数 ISP 文件 都 可 以 使 用 标准 的 ISP 标签 
库 。 此 外 ,我 们 还 可 以 使 用 ISP 表达 式 语 言 来 注入 动态 内 容 , 语法 是 ${ 表 达 式 }， 其 中 “表达 式 ” 
可 以 是 变量 、 字 面 量 、 运 算 符 ， 甚 至 是 对 特定 Java 方 法 的 调用 。 


下 面 我 们 动态 地 把 口味 ( flavor ) 和 配料 (topping) 注入 视图 中 : 















































«select name="flavor"> 
«option value="" selected»«/option» 
<c:forEach items="${flavors}" var="flavor"> 
<option value="${flavor}">${flavor.toString()}</option> 
«/c: forEach> 
</select> 


稍 后 讲解 “口味 ”是 如 何 传递 的 , 但 这 里 我 们 假设 已 经 做 好 了 , 那么 返回 到 客户 端的 HTML 
如 下 所 示 。 


«select name="flavor"> 














«option value="" selected»«/option» 

«option value="VANILLA">Vanilla</option> 

«option value="CHOCOLATE">Chocolate</option> 

«option value="STRAWBERRY">Strawberry</option> 
«/select» 


同样 ， 采 用 类 似 方 法 ， 我 们 还 可 以 注入 配料 和 价格 ， 相 关内 容 见 本 章 示 例 代 码 。 
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6.2.3 ”控制 器 


Spring MVC 控制 器 强大 又 灵活 ， 几 乎 可 以 轻松 满足 任何 需要 。 同 时 ， 通 常 有 几 种 不 同 的 方 
法 可 以 解决 同样 的 问题 ， 当 你 刚 开始 学 习 这 个 框架 时 ， 可 能 会 感到 困惑 。 


在 控制 器 类 上 要 添加 econtroller 注解 ,有 时 还 会 添加 eRequestMapping 注解 ,表示 控制 器 
类 中 所 有 响应 请 求 的 方法 都 以 该 地 址 为 父 路 径 ， 比 如 EmployeeController 中 所 有 响应 请 求 方法 
的 父 路 径 是 /employee。 


在 定义 路 由 时 ，@RequestMapping 注解 也 可 以 用 于 某 个 方法 ， 包括 请 求 的 真实 路 径 ( 比如 
/new ) 和 HTTP 方法 (比如 POST )。 此 外 ， 路 由 方法 非常 灵活 ， 参 数 对 象 有 20 多 种 ， 有 效 返 回 
类 型 超过 15 种 。 因 此 我 们 为 应 用 程序 新 订单 页 面 定义 路 由 的 方法 有 很 多 ， 其 中 之 一 如 下 。 





















































OrderController.java 
20 GRequestMapping(value = "/new", method = RequestMethod.GET) 
24 public String orderForm(Model model) { 
22 model .addAttribute("flavors", 
23 EnumSet.allOf(Flavor.class)); 
24 model.addAttribute("toppings", 
25 EnumSet .allOf(Topping.class)); 
26 return "new-order"; 
21 } 





上 面 的 代码 中 传人 了 一 个 Model ， 我 们 可 以 修改 (或 者 充实 ) 它 ， 使 其 包含 口味 列表 和 配料 
列表 。 比 如 设置 好 flavors 属性 之 后 ， 我 们 就 可 以 在 视图 中 使 用 ${flavors} 表 达 式 来 访问 其 数 
据 了 。 最 后 ， 返 回 类 型 是 一 个 字符 串 ， 用 于 指明 要 使 用 的 视图 。 


为 了 处 理 订 单 ，POST 请 求 需要 发 送 到 相同 的 路 径 。 为 此 ， 我 们 可 以 在 控制 器 中 创建 另外 一 
个 方法 。 























OrderController.java 
29 GRequestMapping(value = "/new", method = RequestMethod.POST) 
30 public String createOrder(@ModelAttribute Order order, Model model) { 
31 double priceNumber = order .getPrice(); 
32 String price = NumberFormat.getCurrencyInstance(Locale.US) 
33 . format (priceNumber); 
34 model .addAttribute("price", price); 
35 return "order-success"; 
36 } 


























fi HjeModelAttribute 注解 ， 请 求 就 神奇 地 自动 转换 成 一 个 order 对 象 。Spring MVC 会 使 
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用 Post 请 求 中 的 表单 数据 属性 调用 Order 类 中 相应 的 setter 方 法 。( 该 框架 也 需要 使 用 getter 和 
setter 方 法 ! ) 此 外 ， 我 们 还 可 以 加 入 一 个 Model ， 用 计算 好 的 价格 “充实 ” 它 ns 返回 一 个 字 
符 串 ， 指 定 响应 要 使 用 的 视图 。 


上 面 这 些 例子 只 是 Spring MVC 控制 絮 强 大 功能 的 冰山 一 角 。 在 你 的 应 用 程序 中 ， 你 可 以 演 
试 控制 需 的 更 多 使 用 方法 ， 以 应 对 更 复杂 的 请 求 -响应 过 程 。 一 开始 你 可 能 不 知 所 措 ， 别 急 ， 慢 
慢 来 ! 





Nd 


















































62.4 配置 


Spring MVC 作为 Spring 工具 ， 我 们 可 以 使 用 XML 文件 或 注解 来 配置 它 。 我 们 举 的 例子 是 
个 非常 小 的 应 用 程序 , 它 所 需要 的 配置 很 少 。 同 样 的 配置 如 何 使 用 XML 和 注解 两 种 方法 来 实现 ， 
示例 如 下 。 

















dispatcher-servlet.xml 





«beans xmlns="http://www.springframework .org/schema/beans" 
xmlns:context-"http://www.springframework.org/schema/context" 
xmlns:xsi-"http://www.w3.0org/2004 /XMLSchema- instance" 
xmlns:mvc-"http://www.springframework.org/schema/mvc" 
xsi:schemaLocation=" 

http://www. 
http://www. 
http://www. 
http://www. 
http://www. 
http://www. 


pringframework.org/schema/beans 
pringframework.org/schema/beans/spring-beans.xsd 





pringframework.org/schema/context 
pringframework.org/schema/context/spring-context.xsd 
pringframework.org/schema/mvc 





s 
s 
s 
s 
s 
springframework.org/schema/mvc/spring-mvc.xsd"» 
«context:component-scan base-package-"com.letstalkdata.iscream" /» 
«bean 
class-"org.springframework.web.servlet.view.InternalResourceViewResolver"» 


«property name="viewClass" 
value-"org.springframework.web.servlet.view.JstlView"/» 
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«property name="prefix" value="/WEB-INF/views/jsp/" /> 


N 
© 


«property name="suffix" value=".jsp" /> 


N 
nie 


</bean> 


N N 
on 


«mvc:annotation-driven /> 


N N 
o m 


</beans> 
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WebConfig.java 





im 
im 
im 
im 
im 
im 


im 
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port 
port 
port 
port 
port 
port 





port 


org. 
org. 
org. 
org. 
org. 
org. 
org. 


@Bean 


package com. letstalkdata.iscream; 


pringframework.context.annotation.Bean; 
pringframework.context.annotation.ComponentScan; 
pringframework.context.annotation.Configuration; 
pringframework.web.servlet.ViewResolver; 








pringframework.web.servlet.view.JstlView; 


@ComponentScan 
@Configuration 
GEnableWebMvc 
public class WebConfig { 


public ViewResolver viewResolver() { 


InternalResourceViewResolver viewResolver = 


new InternalResourceViewResolver(); 


viewResolver.setViewClass(JstlView.class); 


viewResolver.setPrefix("/WEB-INF/views/jsp/"); 


viewResolver.setSuffix(".jsp"); 


return viewResolver; 


pringframework.web.servlet.config.annotation.EnableWebMvc; 
pringframework.web.servlet.view.InternalResourceViewResolver; 





该 配置 告知 Spring MVC 如 何 为 应 用 程序 查找 视图 。 


最 后 , 我 们 需要 配置 应 用 程序 , 使 之 在 servlet 容器 中 运行 。 前 面 讲 过 ， 





























这 通常 是 





通过 web.xml 


文件 来 实现 的 。web.xml 文件 位 于 WEB-INF 目录 之 下 ， 其 中 定义 了 一 个 servlet， 它 会 和 其 他 配 
置 选项 一 起 被 注册 到 容 需 中 。 


web.xml 





G (o 0 -10 0 B5 Qo M H 


ne 


xmlns:xsi-"http://www.w3.0org/2004/XMLSchema- instance" 
xsi:schemaLocation="http://xmlns. jcp.org/xml/ns/ javaee 


<?xml version-z"1.0" encoding-"UTF-8"?» 


«web-app xmlns-"http://xmlns.jcp.org/xml/ns/javaee" 


http: //xmlns.jcp.org/xml/ns/javaee/web-app. 3. 1.xsd" 


versionz"3.1"» 


«servlet» 


«servlet-name»dispatcher«/servlet-name» 


«servlet-class» 


org.springframework.web.servlet.DispatcherServlet 
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«/servlet-class» 
«init-param» 
«param-name»contextConfigLocation«/param-name» 
«param-value»/WEB-INF/dispatcher-servlet.xml«/param-value» 
«/init-param» 
«load-on-startup»1«/load-on-startup» 


«/servlet» 


«servlet-mapping» 


«servlet-name»dispatcher«/servlet-name» 
«url-pattern»/«/url-pattern» 


«/servlet-mapping» 


«/web-app» 








你 可 以 使 用 一 个 Java 对 象 来 完成 这 项 工作 。 


Web ApplicationInitializer.java 





package com. letstalkdata.iscream; 


impor 


import 


impor 


import 


impor 


import 





org.springframework.web.WebApplicationInitializer; 
org.springframework.web.context .ContextLoaderListener ; 
org.springframework.web.context.support 
.AnnotationConfigWebApplicationContext; 
org.springframework.web.servlet.DispatcherServlet; 


javax.servlet.ServletContext; 





javax.servlet.ServletRegistration; 


public class WebAppInitializer implements WebApplicationInitializer { 


GOverride 


public void onStartup(ServletContext container) { 


AnnotationConfigWebApplicationContext context 
- new AnnotationConfigWebApplicationContext(); 
context.setConfigLocation("com.letstalkdata.iscream.WebConfig"); 


container.addListener(new ContextLoaderListener(context)); 
DispatcherServlet dispatcherServlet - new DispatcherServlet(context); 
ServletRegistration.Dynamic dispatcher - container 


.addServlet("dispatcher", dispatcherServlet); 


dispatcher.setLoadOnStartup(1); 
dispatcher.addMapping("/"); 
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这 样 , 现 在 就 可 以 把 应 用 程序 部 署 到 servlet 容器 中 了 。 但 是 ， 如 果 你 想 试 一 下 示例 代码 ， 可 
以 运行 gradle appRun, 它 将 在 你 的 计算 机 上 启动 一 个 非常 小 的 servlet t8 ( Gretty )， 并 将 应 用 
程序 部 署 到 http://localhost:8080。 














6.3 Spring Boot 


5.2 节 介 绍 了 Spring Boot， 以 及 使 用 它 快 速 开 发 应 用 程序 的 方法 。 通 过 另外 添加 一 个 starter, 
我 们 可 以 使 用 Spring Boot 轻松 构建 Spring MVC Web 应 用 程序 。 


使 用 Spring Boot 的 主要 优 ， quoi in Spring Boot Web 应 用 程序 既 没 有 web.xml, 也 
没有 WebApplicationInitializer 类 ,而 且 , 也 不 必 创 建 @WebConfig 类 或 dispatcher-servlet.xml。 
在 类 路 径 上 有 spring-boot-starter-web starter， 足 以 配置 应 用 程序 了 



































6.3.1 Thymeleaf 


尽管 我 们 可 以 在 Spring Boot 应 用 程序 中 使 用 ISP 技术 , 但 还 是 推荐 使 用 DUM UU 
来 创建 视图 。 只 要 Thymeleaf 在 类 路 径 上 ， 它 就 会 自动 用 作 应 用 程序 视图 泻 染 器 。Thymeleaf 5| 
擎 与 JSP 技术 类 似 , 但 它们 有 一 个 明显 的 区 别 , 那 就 是 Thymeleaf 视图 是 COHTML 文件 , 并 且 使 
用 自 定 义 属 性 代替 标签 。 作 为 对 比 ， 下 面 的 示例 使 用 Thymeleaf 把 flavor 加 载 到 视图 中 。 


«select class-"form-control" id="flavor" name="flavor"> 





















































«option valuez"" selected-"selected"»«/option» 
«option th:each="flavor : ${flavors}" 
th:value-"$(flavor.name()]" 
th:text-"$[flavor]"»«/option» 
</select> 


可 以 看 到 ， 上 面 的 代码 与 HTML 很 像 , 带 “th” 前 绥 的 属性 提供 处 理 逻 辑 。 按 照 约 定 ,“th 
是 http://www.thymeleaf.org 的 别名 。 


由 于 使 用 的 是 HTML, 所 以 这 些 视 图 可 以 直接 加 载 到 浏览 器 中 ， 而 无 须 运 行 应 用 程序 。 如 下 
图 所 示 。 
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c CQ (y b file:/J|spring-mvc-boot/src/main/resources/templates/new-order.html 


New Order 


Flavor 


<> 


Scoops 


Toppings 


图 6-1. 浏览 器 中 的 Thymeleaf 视 图 


显然 ,服务 器 端的 数据 没有 在 视图 中 呈现 出 来 , 但 是 它 可 以 让 你 大 臻 了解 布局 和 样式 , 加 快 
端 设计 迭代 。 如 果 你 想 深 入 了 解 Thymeleaf， 请 参考 官方 文档 。 


























6.3.2 ”运行 Spring Boot Web 应 用 程序 


前 面 讲 过 ，Java Web 应 用 程序 在 servlet 容器 中 运行 。 把 应 用 部 署 到 容器 中 要 花 几 分 钟 (应 用 
程序 越 复杂 ， 所 需 时 间 就 越 长 )， 这 在 开发 期 间 会 很 烦人 。 为 了 加 快速 度 ， 你 可 以 使 用 插件 把 应 
用 程序 部 署 到 一 个 轻 量 级 的 本 地 容器 中 。 本 章 选 用 了 Gretty 插件 ， 你 可 以 运行 gradle appRun 
来 调用 它 。 Spring Boot 采 用 了 类 似 的 方法 , 但 是 它 并 不 把 容器 和 应 用 程序 看 作 独 立 的 实体 , Spring 
Boot 会 把 一 个 容器 ( Tomcat ) 艇 在 你 的 应 用 程序 中 。 当 在 命令 行 中 输入 java -jar .. .命令 或 者 
在 IDE 中 运行 main 类 时 ， 骨 入 的 容器 会 自动 启动 。 这 使 得 本 地 开发 和 产品 部 署 一 样 简单 。 








6.4 JavaServer Faces 








JavaServer Faces (JSF ) 是 一 种 构建 Web 应 用 程序 的 技术 ， 它 侧重 于 应 用 程序 的 UI， 而 非 后 
端 连 接 。 事 实 上 ,控制 器 对 开发 者 几乎 是 完全 隐藏 的 , 开发 者 开发 程序 的 时 间 主 要 花 在 了 模型 和 
MERE. LSKL, 本 书 介绍 了 构建 Web 应 用 程序 的 多 种 技术 ， 其 中 ,JSF 可 能 是 社区 中 最 具 争 
议 性 的 技术 。 有 些 人 批评 它 对 开发 者 隐藏 得 太 多 , 增加 了 有 状态 性 , 并 将 视图 和 模型 耦合 得 太 紧 。 
而 有 些 开发 者 称赞 其 可 复 用 性 和 生产 力 。 
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6.4.1 托管 Bean 
与 Spring 不 同 , 使 用 JSF 时 ， 我 们 不 会 手动 向 视图 中 注入 东西 。JSF 应 用 程序 会 创建 并 访问 





“托管 bean” 来 与 模型 交互 。 创 建 托管 bean 就 像 在 类 中 添加 eManagedBean 注解 一 样 简单 。 此 外 ， 


完整 的 


m 


口 
a 





对 于 [Scream 应 用 程序 , 我 创建 了 一 个 所 有 用 户 都 可 以 使 用 的 IngredientService 25, 并 且 
设置 Order 类 的 作用 域 为 RequestScoped。 


此 
类 中 创 


托管 bean 指定 作用 域 ， 以 告知 应 用 程序 要 保留 多 久 。Oracle 公司 的 Java EE 使 用 说 明 中 有 
作用 域 列 表 ， 和 常见 的 作用 域 如 下 所 示 。 


ApplicationScoped: 在 应 用 程序 的 整个 运行 期 间 都 存在 。 该 作用 域 通 常用 于 全 局 bean, 
以 便 多 个 用 户 访问 它们 。 

SessionScoped: 只 在 用 户 会 话 期 间 存 在 。 

RequestScoped: 只 存在 于 一 个 请 求 -响应 周期 中 ( 默认 的 作用 域 )。 


















































外 ,托管 bean 还 可 以 管理 那些 视图 可 以 访问 的 属性 ,因为 JSF 是 有 状态 的 ,所 以 我 在 Order 
建 了 几 个 托管 属性 。 稍 后 展示 使 用 方法 。 























IngredientService.java 





package com.letstalkdata.iscream.service; 
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port com.letstalkdata.iscream.domain.Flavor; 
port com.letstalkdata.iscream.domain.Topping; 


port javax.faces.bean.ApplicationScoped; 
port javax.faces.bean.ManagedBean; 





port java.util.ArrayList; 
port java.util.EnumSet; 
port java.util.List; 

U 


port java.util.stream.Collectors; 


GManagedBean(name - "ingredientsService") 


pplicationScoped 





blic class IngredientsService { 


public List«String» getFlavors() { 
List«String» flavors = new ArrayList<>(); 
flavors.add(""); 
flavors.addAll(EnumSet.allOf(Flavor.class).stream() 
.map(Flavor::toString) 
.collect(Collectors.toList())); 
return flavors; 
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25 
26 
27 
28 
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public List«String» getToppings() ( 
return EnumSet.allOf(Topping.class).stream() 
.map(Topping::toString) 
.collect(Collectors.toList()); 





Order.java 





package com.letstalkdata.iscream.domain; 


import javax.faces.bean.ManagedBean; 
import javax.faces.bean.ManagedProperty; 
import java.text.NumberFormat; 

import java.util.ArrayList; 

import java.util.Arrays; 

import java.util.List; 





import java.util.Locale; 


@ManagedBean 

public class Order { 

private String flavor; 

private int scoops = 1; 

private List<Topping> toppings = new ArrayList<>(); 


@ManagedProperty("formattedPrice" ) 
private String formattedPrice; 


@ManagedProperty("saved" ) 
private boolean saved; 





public Order() { 


public Order(String flavor, int scoops, Topping... toppings) { 
this.flavor = flavor; 
this.scoops = scoops; 
this.toppings = Arrays.asList(toppings); 


public String getFlavor() { 
return flavor; 


public void setFlavor(String flavor) { 
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38 this.flavor - flavor; 
39 } 
40 
41 public int getScoops() { 
42 return scoops; 
43 } 
44 
45 public void setScoops(int scoops) { 
46 this.scoops = scoops; 
47 } 
48 
49 public List<Topping> getToppings() { 
50 return toppings; 
54 } 
52 
53 public void setToppings(List«Topping» toppings) { 
54 this.toppings = toppings; 
55 } 
56 
57 public String getFormattedPrice() { 
58 return formattedPrice; 
59 } 
60 
61 public void setFormattedPrice(String formattedPrice) { 
62 this.formattedPrice - formattedPrice; 
63 } 
64 
65 public boolean isSaved() { 
66 return saved; 
67 } 
68 
69 public void setSaved(boolean saved) { 
70 this.saved = saved; 
74 } 
72 
73 private double calculatePrice() { 
74 return scoops x 1.50d + toppings.size() * @.25d; 
75 } 
76 
77 public void save() { 
78 this.saved = true; 
79 formattedPrice = NumberFormat. getCurrencyInstance(Locale.US) 
80 . format(calculatePrice()); 
81 } 
82 
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6.4.2 JSF 视图 





JSF 视图 类 似 于 Thymeleaf， 也 是 XHTML 文件 ， 使 用 自 定义 扩展 告诉 服务 器 如 何 构建 响应 。 
Ait, JSF 更 依赖 自 定义 的 标签 。 实 际 上 ， 大 多 数 JSF XHTML 文件 几乎 都 使 用 自 定义 标签 。 使 
用 JSF 创建 熟悉 的 “flavors” 方 法 如 下 。 


«h:selectOneMenu id="flavor" class-"form-control" h:value="#{order.flavor}"> 








<f:selectItems value-"s([ingredientsService.flavors]" var="flavor" 
itemLabel="#{flavor}" itemValue="#{flavor}" /> 
«/h:selectOneMenu» 


上 面 的 代码 中 ， 托 管 bean ( ingredientsService ) 用 于 填充 select 列表 项 目 。 更 重要 的 是 
还 可 以 看 到 h:value="#{order .flavor}"， 这 正 是 我 们 把 视图 数据 绑 定 到 模型 的 方法 。order 
bean 是 受托 管 的 ， 我们 有 setFlavor 方法 ， 所 以 可 以 访问 flavor 的 值 。 


把 数据 绑 定 到 模型 之 后 ,我 们 需要 把 计算 好 的 费用 呈现 给 用 户 。 为 此 , 我 们 可 以 使 用 JSF 对 
AJAX 的 内 置 支持 来 代替 页 面 重 定向 。 利 用 order bean 的 托管 属性 也 在 此 处 。 处 理 AJAX 请 求 的 
JSP 代码 如 下 所 示 。 















































new-order.xhtml 




















33 «h:commandButton class="btn btn-primary" value="Create Order" 
34 action="#{order.save}"> 

35 «f:ajax execute="@form" render="orderDisplay"/> 

36 «/h:commandButton» 

37 <br/> 

38 <h:panelGroup id="orderDisplay" layout="block"> 

39 «h:panelGroup rendered="#{order.saved}"> 

AQ «h:outputText value-"Order Saved!"/» 

41 <br/> 

42 «h:outputText value="Flavor: #{order.flavor}"/> 

43 <br/> 

44 <h:outputText value="Scoops: #{order.scoops}"/> 

45 <br/> 

46 <h:outputText value="Toppings: #{order.toppings}"/> 

AT <br/> 

48 <h:outputText id="priceDisplay" 

49 value="The total is: #{order.formattedPrice}"/> 
50 «/h:panelGroup» 

51 «/h:panelGroup» 


























页 面 加 载 时 ， 订 单 没 有 详细 信息 ， 所 以 无 法 计算 价格 。 但 是 ， 由 于 order 是 一 个 托管 bean， 
所 以 当 用 户 提交 AJAX 请 求 时 ，setter 方法 就 会 将 详细 信息 注入 订单 之 中 。 此 外 ，save( ) 方 法 会 
执行 ， 因 为 它 被 指派 了 commandButton 的 action 属性 。 然 后 save( ) 方 法 更 改 saved 属性 。 由 
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于 saved 属性 值 (布尔 值 ) 决定 panelcroup 可 见 性 ， 所 以 panelGroup 就 显示 出 来 了 。 最 后 ， 
访问 formattedPrice JHA MA. 





























要 运行 演示 应 用 程序 ， 你 可 以 再 次 运行 gradleappRun 命令 。 不 过 ,在 使 用 JSF 时 ,通常 不 
需要 指定 访问 路 径 ， 它 们 通常 是 基于 webapp 内 部 的 文件 结构 的 。 因 此 ， 要 访问 订单 页 面 ， 请 前 
往 http://localhost:8080/new-order.xhtml。 

















6.5 Vaadin 


Web 应 用 程序 开发 者 们 面临 一 个 共同 挑战 ， 他 们 需要 充分 理解 服务 器 端 语言 和 前 端 技术 : 
JavaScript, CSS 和 HTML。 这 使 得 近年 来 服务 器 端的 JavaScript 变 得 越发 流行 。 但 是 对 于 Java Web 
开发 者 来 说 ， 这 个 障碍 仍然 存在 。 即 使 熟悉 各 种 Web 技术 并 且 经 验 丰 富 的 开发 者 也 要 花费 大 量 
时 间 把 前 端 和 后 端 连接 起 来 。 为 此 ，Google 推出 了 GWT (Google Web Toolkit )， 它 能 把 纯 Java 
代码 编译 为 HTML 和 JavaScript。 其 实 ， 现 在 GWT 仍然 是 切实 可 行 的 Web 框架 。Vaadin 建立 在 
GWT 之 上 ， 其 目标 是 简化 和 抽象 GWT 中 一 些 复杂 的 部 分 。 


类 似 于 JSF，Vaadin 也 对 开发 者 隐藏 了 请 求 - 响 应 周期 ， 并 且 没 有 明确 的 “控制 器 ”概念 。 
另外 ,使 用 Vaadin 时 ， 你 不 必 创 建 任 何 HTML 视图 文件 "。 大 部 分 Web 应 用 程序 都 可 以 完全 用 
Java 来 设计 ， 不 过 ， 如 果 需 要 定制 样式 或 高 级 客户 端 组 件 ， 你 可 以 使 用 CSS 或 JavaScript 来 扩 
Fé Vaadin, 

































































6.5.1 布局 和 组 件 


通常 Vaadin 中 的 视图 是 通过 把 组 件 添加 到 布局 中 构建 的 。 其 中 ， 组 件 对 象 有 文本 域 、 选 择 
列表 、 标 题 、 网 格 、 按 钮 ， 或 者 其 他 布局 。 要 创建 新 订单 界面 ， 先 要 创建 一 个 VerticalLayout, 
它 包 含 一 个 FormLayout ， 用 以 显示 订单 详细 信息 ; 还 要 创建 一 个 verticalLayout ， 用 于 显示 
价格 。 








OrderScreen.java 





package com.letstalkdata.ui; 


import com.letstalkdata.domain.Flavor; 
import com.letstalkdata.domain.Order; 
import com.letstalkdata.domain.Topping; 


import com.vaadin.ui.x; 


-10 0i 5 CO M 7^ 


import com.vaadin.ui.themes.ValoTheme; 








Q@ Vaadin 商业 版 本 支持 访问 设计 器 工具 ， 这 人 允许 你 使 用 GUI 构建 视图 。 虽 然 设计 器 的 确 创建 了 一 个 HTML 文件 ， 
但 是 你 很 少 直接 与 它 交互 。 
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import java.text.NumberFormat; 
import java.util.EnumSet; 
import java.util.Locale; 


public class OrderScreen extends VerticalLayout { 


private OrderDetailsForm orderDetailsForm; 
private OrderSavedLayout orderSavedLayout; 


public OrderScreen() { 
orderDetailsForm - new OrderDetailsForm(); 
orderSavedLayout - new OrderSavedLayout(); 


addComponent (orderDetailsForm); 
addComponent (orderSavedLayout) ; 


private class OrderDetailsForm extends FormLayout { 
private NativeSelect<Flavor> flavor; 
private TextField scoops; 
private CheckBoxGroup«Topping» toppings; 
private Button submit; 


public OrderDetailsForm() { 

flavor = new NativeSelect<>( 
"Flavor", 
EnumSet.allOf(Flavor.class)); 

Scoops - new TextField("Scoops"); 

toppings = new CheckBoxGroup«»( 
"Toppings", 
EnumSet.allOf(Topping.class)); 


submit - new Button("Submit"); 
submit.setStyleName(ValoTheme.BUTTON. PRIMARY); 
submit.addClickListener(click -» { 
Order order - new Order( 
flavor.getValue().toString(), 
Integer.parseInt(scoops.getValue()), 
toppings.getValue().toArray(new Topping[]())); 
orderSavedLayout.showDetails(order); 


E); 


addComponent( flavor); 
addComponent (scoops); 
addComponent (toppings); 
addComponent ( submit) ; 
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private static class OrderSavedLayout extends VerticalLayout { 


Label orderDetails; 


OrderSavedLayout() { 
setVisible( false); 
setMargin( false); 


orderDetails = new Label(); 


addComponent ( orderDetails); 


void showDetails(Order order) { 
setVisible(true); 
double priceNumber - order.getPrice(); 


String price = NumberFormat.getCurrencyInstance(Locale.US) 


. format(priceNumber); 


orderDetails.setValue("Order Saved! Total: " + price); 





由 于 Vaadin 中 不 存在 明确 的 控制 器 或 者 对 请 求 的 引用 , 所 以 我 们 可 以 在 编译 时 “填充 ”flavor 
和 toppings 控件 。 类 似 地 ,我 们 并 不 关心 应 用 程序 如 何 响应 用 户 点 击 提交 按钮 ， 而 关心 用 户 点 击 
那个 按钮 时 会 发 生 什 么 ， 这 正 是 需要 我 们 通过 编码 实现 的 。 


6.5.2 Vaadin UI 


TE Vaadin 应 月 















































程序 中 创建 UI 就 像 定义 路 径 一 样 。 不 过 , 与 传统 Web 应 用 程序 不 同 , 大 多 数 














Vaadin 应 用 程序 只 有 少量 路 径 ， 很 多 只 有 一 条 。 一 个 Vaadin UI 就 是 一 个 单 页 Web 应 用 ( SPA ), 
不 同 的 页 面 可 以 通过 实现 View 接口 呈现 给 用 户 。 


0 -10 0 5» OQ MN 7 











在 IScream UI 中， 我 们 创建 一 个 OrderScreen 实例 ， 并 将 其 设置 为 UI 根 路 径 。 


OrderUl.java 








package com.letstalkdata.ui; 


import javax.servlet.annotation.WebServlet; 


import com. 
import com. 
import com. 
import com. 


vaadin. 
vaadin. 
vaadin. 


vaadin. 


annotations.Theme; 
annotations.VaadinServletConfiguration; 
server.VaadinRequest; 
server.VaadinServlet; 
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9 import com.vaadin.ui.*; 

0 

1 | @Theme(""mytheme" ) 

2 public class OrderUI extends UI { 

3 

4 GOverride 

5 protected void init(VaadinRequest vaadinRequest) { 

6 OrderScreen orderScreen - new OrderScreen(); 

7 setContent(orderScreen); 

8 j 

9 

20 GWebServlet(urlPatterns - "/x", 

21 name = "OrderUIServlet", asyncSupported = true) 

22 @VaadinServletConfiguration(ui = OrderUI.class, productionMode = false) 
23 public static class OrderUIServlet extends VaadinServlet { 
24 } 





6.5.3 ”主题 


每 个 UI 都 能 有 自己 的 主题 ,这些 主题 可 以 通过 SASS (CSS 扩展 ) 创建 。 除 非 你 执意 要 自己 
定制 风格 ， 不 然 最 好 在 Vaadin 的 现 有 主题 之 上 构建 。 对 于 示例 程序 ， 我 选用 了 Valo 主题 作为 根 


mytheme.scss 6 
































1 @import "../valo/valo.scss"; 
2 

3 @mixin mytheme { 

4 @include valo; 

5 

6 // 在 此 插入 自 定义 主题 

T 3} 

















上 面 的 代码 不 包含 任何 定制 ， 如 果 你 需要 ， 可 以 插入 自己 的 主题 。 此 外 ， 你 还 应 把 SCSS E 
题 编 译 成 CSS, 使 用 Maven Vaadin 插件 可 以 轻松 实现 。( 查看 示例 代码 中 的 README.md 文件 获 
取 更 多 细节 。) 











6.5.4 运行 应 程序 


Vaadin Maven 插件 包含 一 个 简单 的 Web 服务 器 ， 可 以 在 开发 期 间 运 行 应 用 程序 。 运 行 mvn 
jetty:run, 访问 http://localhost:8080/。 如 果 你 定义 了 多 个 UL, 可 以 分 别 通过 http://localhost:8080/ 
my-main-ui, http://localhost:8080/my-other-ui 等 地 址 访问 。 
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6.6 小结 


本 章 只 介绍 了 目前 仍然 在 使 月 
用 程序 的 多 种 方法 。 


我 们 先 介绍 了 传统 的 开发 

















目的 几 个 典型 Java Web 框架 ， 并 且 特 意 展 示 了 开发 Java Web 应 








EX Spring MVC， 涉 及 了 请 求 、 响 应 等 相关 知识 ， 并 且 讲 解 了 使 

















用 Spirng Boot 轻松、 快速 开发 Spring MVC 应 用 程序 的 方法 。 我 们 还 讲 到 了 Vaadin， 在 很 大 程度 
E, 使 用 它 进行 开发 就 像 开 发 桌面 应 用 程序 一 样 。 中 间 还 提 到 了 JSF, 它 对 开发 者 隐藏 了 控制 器 ， 
而 着 重 于 视图 构建 。 每 一 个 都 各 有 所 长 ， 并 且 都 很 常用 。 


此 外 ， 我 们 还 介绍 了 各 种 视图 构建 技术 。JSP 是 最 老 的 一 种 ， 它 使 用 表达 式 语言 实现 基本 逻 
辑 。 Spring 扩展 了 表达 式 语言 , 使 得 Spring 应 用 程序 更 易 使 用 。JSF 和 Thymeleaf 都 使 用 XHTML ， 
但 方法 略 有 不 同 。Thymeleaf 视图 主要 使 用 带 有 特殊 属性 的 HTML 标签 ， 而 JSF 视图 几乎 只 使 用 
自 定 义 标 签 。 最 后 ，Vaadin 据 弃 了 视图 文件 ， 转 而 使 用 Java 来 定义 视图 。 


从 许多 方面 来 说 ， Java Web 应 用 程序 可 能 是 传统 公司 会 开发 的 最 复杂 的 应 用 程序 了 。 而 且 开 
发 时 并 非 总 会 遵循 这 些 最 佳 实践 ， 有 些 框架 也 不 够 灵活 。 其 间 ， 最 重要 的 是 要 花 时 间 了 解 公司 所 
使 用 的 框架 以 及 开发 者 使 用 这 些 框架 的 方式 。 
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取决 于 公司 规模 ,你 可 能 永远 都 不 需要 自己 部 署 代 码 ， 因为 有 专门 的 部 署 团 队 会 负责 。 尽管 
如 此 ， 你 还 是 应 该 熟悉 代码 的 部 署 方式 ， 只 有 这 样 ， 你 才能 正确 地 维护 项 目的 构建 文件 。 另 外 ， 
如 果 你 在 一 个 较 小 的 团队 中 ， 那 么 你 很 可 能 也 需要 了 解 如 何 部 署 自己 创建 的 项 目 。 

与 控制 台 应 用 程序 不 同 ，Java Web 应 用 程序 并 不 是 从 命令 行 运行 的 ( 尽管 会 有 例外 )。 相 反 ， 
它们 在 应 用 程序 服务 器 内 部 运行 ， 这 些 服 务 器 负责 处 理 对 你 的 代码 的 请 求 ， 并 且 把 响应 返回 到 
Web 服务 器 。 





























7.1 打包 
Java 应 用 程序 有 两 种 常用 的 打包 方法 : WAR 文件 和 EAR 文件 。 


WAR ( Web Application aRchive ) 文件 和 JAR 文 件 完全 一 样 ， 二 者 只 是 扩展 名 不 同 ， 这 样 做 
是 为 了 便于 将 其 识别 为 Web 应 用 程序 。 当 WAR 用 作 部 署 构件 时 , 它 包 含 应 用 程序 运行 所 需 的 所 
有 代码 ， 比 如 领域 对 象 、 控 制 器 、 视 图 文件 等 。 


EAR (Enterprise Application aRchive ) 文件 是 类 型 不 同 的 部 署 归 档 文件 ， 它 同时 包含 WAR 
文件 和 JAR 文件 。 通 常 在 使 用 EAR 文件 时 ，WAR 文件 只 包含 Web 应 用 程序 相关 代码 。 领 域 对 
象 、 服 务 等 (这 里 指 的 是 EJB ) 都 打包 在 JAR 文件 中 。 理论 上 , 这 意味 着 不 同 团 队 可 以 在 不 同 代 
E (Web 代码 和 领域 代码 ) 上 工作 。 而 且 ， 多 个 Web 应 用 程序 可 以 共享 同样 的 领域 对 象 。 


本 书 示例 代码 包含 的 项 目 中 , 一 个 打包 成 了 WAR 文件 , 另 一 个 打包 成 了 EAR 文件。 下 面 比 
较 一 下 二 者 的 文件 结构 。 


WAR 文件 结构 









































上 一 META-INF 
| L— MANIFEST.MF 
L— wEB-INF 
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| 一 classes 
L— com 
L— letstalkdata 
L— iscream 
一 controller 
| |l— OrderController.class 
| L— WelcomeController.class 
L— domain 
|— Flavor.class 
|l— Order.class 
L— Topping.class 


dispatcher-servlet.xml 

lib 

| 一 commons-1ogging-1.2.jar 

| 一 jst1-1.2.jar 

| 一 spring-aop-4.3.9.RELEASE. jar 

| 一 spring-beans-4.3.9.RELEASE. jar 
| 一 spring-context-4.3.9.RELEASE. jar 
|— spring-core-4.3.9.RELEASE. jar 
一 spring-expression-4.3.9.RELEASE. jar 
|— spring-web-4.3.9.RELEASE. jar 

L— spring-webmvc-4.3.9.RELEASE. jar 
views 


[一 jsp 
LI— new-order. jsp 
| 一 order-success. jsp 


ee Wi ae ete SN. Ur MEME DEDE 


L— welcome. jsp 
L— web.xml 





EAR 文件 结构 





| 一 META-INF 

上 一 MANIFEST. MF 

L— application.xml 
l— iscream-ejb.jar 


|l— META-INF 
| L— MANIFEST.MF 
L— com 


L— letstalkdata 
L— iscream 
L— domain 
|— Flavor.class 
|— Order.class 
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| L— Topping.class 
L— iscream-web.war 

一 META-INF 

| L— MANIFEST.MF 

L— WEB-INF 

| 一 classes 

| L— com 
| L— letstalkdata 
| L— iscream 
| 一 WebAppInitializer.class 
| | 一 WebConfig.class 
| L— controller 
| I— OrderController.class 
| L— WelcomeController.class 
I— lib 
Il— commons-1ogging-1.2.jar 
I— spring-aop-4.3.9.RELEASE. jar 
| 一 spring-beans-4.3.9.RELEASE. jar 
I— spring-context-4.3.9.RELEASE. jar 
|I— spring-core-4.3.9.RELEASE. jar 
I— spring-expression-4.3.9.RELEASE. jar 
HF spring-web-4.3.9.RELEASE. jar 
L— spring-webmvc-4.3.9.RELEASE. jar 
L— views 

[一 jsp 


| 一 new-order . jsp 
I— order-success. jsp 
L— welcome.jsp 





如 你 所 见 ，WAR 文件 包含 应 用 程序 所 需 的 一 切 : 控制 器 、 视 图 、 领 域 对 象 等 。EAR 文件 包 
含 一 个 WAR 文件 ， 里面 不 含 任何 领域 对 象 ， 领 域 对 象 被 移 至 iscream-ejb.jar 中 了 。EAR 还 包含 
一 个 application.xml 文件 ， 用 于 对 部 署 容器 提供 相关 说 明 。 你 也 可 以 手动 创建 这 个 文件 ， 但 是 最 
好 使 用 构建 工具 创建 它 。 





























7.2 ”部署 


最 常用 的 应 用 程序 服务 器 有 Tomcat 和 JBoss/WildFly。 它们 都 能 部 署 WAR 文件 ,但 是 Tomcat 
不 能 部 署 EAR 文件 。 当 然 还 有 其 他 选择 ， 包 括 Glassfish, Jetty, JOnAS, Resin 等 ， 但 是 它们 不 
AU. 

Fifi 
都 支持 它们 。 





























应 用 程序 部 署 ( 和 取消 部 署 ) 到 应 用 程序 服务 器 的 几 种 常用 方法 ,但 并 非 所 有 工具 








[È 
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(1) 文 档 拖 放 : 如 果 应 用 程序 服务 器 在 运行 时 监视 某 个 文件 夹 , 我 们 就 可 以 把 任意 Java 归档 

















文件 拖 和 人 这 个 文件 夹 中 ， 这 样 Java 归档 文件 就 自动 部 署 完成 了 。 这 在 开发 过 程 中 特别 有 用 ， 你 


可 能 只 想 把 开发 项 目 快速 部 署 到 开发 服务 器 中 


o 


(2) GUI: 通常 你 可 以 在 根 上 下 文 ( 比如 http://my-server:8080/ ) 下 访问 应 用 程序 服务 器 的 Web 


接口 。 你 可 以 从 这 里 看 到 哪些 应 用 程序 在 运行 




















， 以 及 部 署 一 个 新 应 用 程序 。 


(3) 控制 台 : 如 果 应 用 程序 服务 器 含有 命令 行 组 件 , 你 可 以 运行 CLI, 并 在 其 中 管理 应 用 程序 。 
(4) API: 如 果 你 有 一 个 构建 和 测试 应 用 程序 的 持续 集成 服务 器 , 那么 使 用 API 来 部 署 构件 会 








特别 有 用 。 一 旦 构建 成 功 ， 你 就 可 以 选择 自动 部 署 代 码 。 


























在 实践 中 , 你 可 以 在 自己 的 计算 机 上 安装 一 个 或 多 个 应 用 程序 服务 器 , 并 构建 示例 项 目 来 创 


建构 件 。 或 者 ， 你 也 可 以 使 用 Docker Ek 




















巴 任 何 东 西 直 接 安装 到 自己 的 计算 机 上 。 本 书 附 录 








A 会 详细 讲解 Docker 相关 内 容 。 简 单 地 说 ，Docker 是 一 个 实用 工具 ， 人 允许 你 在 自己 的 计算 机 上 
轻松 创建 和 销毁 被 隔离 的 “容器 ”。 方 便 起 见 ， 示 例 项 目 中 提供 了 docker-build.sh 和 
docker-run.sh 脚本 。 这 两 个 脚本 都 采用 了 “文件 拖 放 ”的 方法 把 构件 放 入 特定 文件 夹 中 , 应 用 
































程序 服务 器 启动 时 会 检查 这 个 文件 夹 。 对 于 Tomcat， 这 个 文件 夹 是 SITOMCAT INSTALL DIR/ 


webapps， 对 于 WildFly 则 是 $WILDFLY_-INSTALL DIR/standalone/deployments。 这 两 种 应 用 程 
序 服务 器 〈 标准 端口 ) 下 使 用 的 不 同方 法 如 下 所 示 。 


文件 夹 监视 


D Tomcat: $INSTALL. DIR/webapps 





GUI 


D Tomcat 
(1) 访问 http://server:8080/manager v 


Q WildFly: $INSTALL_DIR/standalone/deployments 


(2) 点 击 “ 选 择 文件 ”按钮 ， 选 择 你 的 .war。 





(3) 点 击 “ 上 传 ”。 

a WildFly 
(1) 访问 http://server:9990/console. 
(2) 点 击 “ 部 署 ” 下 的 “开始 ”按钮 。 
(3) 根据 操作 指引 一 步 步 操作 。 


控制 台 


口 Tomcat: 不 适用 
口 WildFly 
(1) 运行 $INSTALL_DIR/bin/jboss-cli 




















.Sh -Co 
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(2) 运行 命令 deploy path/to/war/iscream-ejb.war. 
API 


O Tomcat: 疝 http://server:8080/manager/text/deploy?path=/iscream 发 送 一 个 HTTP PUT. 
a WildFly: 

(1) 使 用 HTTP POST 向 http://server:9990/management/add-content 发 送 文 件 。 

(2) 记 下 响应 中 的 BYTES. VALUE . 

(3) 把 下 面 这 个 JSON 发 至 http://localhost:9990/management. 








{ 
"content": [("hash": {"BYTES_VALUE": "YOUR VALUE HERE"}}], 


"address": [{"deployment":"iscream-ejb.ear"}], 
"operation": "add", 
"enabled": "true" 


BRAS AS BE 


运行 Web 应 用 程序 的 最 后 一 个 选择 是 把 Java 应 用 程序 服务 器 包含 在 Web 应 用 程序 中 。 其 中 
最 常用 的 两 个 Java 应 用 程序 服务 器 是 Jetty 和 Tomcat， 因 为 它们 都 有 肯 人 式 版 本 。 通 过 把 应 用 程 
序 服务 器 放 入 代码 中 ， 你 可 以 把 代码 看 作 命令 行 应 用 ， 并 使 用 java -jar 命令 运行 它 。 实 际 上 ， 
这 正 是 Spring Boot 对 其 Web 应 用 程序 所 做 的 事情 ( 参考 6.3 节 )。 
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JoshLong. Deploying Spring Boot Applications, 2014-03-07. 
https: //spring.10/blog/2014/03/07/deploying-spring-boot-applications. 


Luca Stancapiano. Mastering Java EE Development with WildFly: Packt, 2017. 
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使 用 数据 库 








了 解 如 何 访问 和 修改 存储 在 数据 库 中 的 数据 ， 对 Java 开发 者 来 说 至 关 重 要 。 虽 然 有 转变 成 
服务 的 趋势 ， 但 目前 大 多 数 应 用 程序 仍然 直接 和 数据 库 打 交道 !〈 当然 ， 这 些 服务 最 终 也 必须 与 
数据 库 打交道 ! ) 


可 以 想见 ， 对 于 数据 访问 ，Java 提供 了 大 量 选择 。 至 于 如 何 选 择 , 取决 于 你 是 否 想 编写 SQL 
语句 。 如 有 果 你 的 团队 熟悉 SQL 语句 ， 又 用 到 了 复杂 的 数据 ， 或 者 需要 底层 SQL 访问 ， 那 么 数据 
框架 中 会 封装 有 大 量 手写 SQL 代码 。 如 果 你 的 团队 不 怎么 了 解 SQL, 或 者 用 到 的 数据 相当 简单 ， 
你 可 以 诉 诸 ORM 解决 方案 ,其 中 可 能 只 有 几 个 SQL 片段 ,用 于 解决 特别 坏 手 的 问题 。 显 然 ， 这 
两 种 方法 各 有 优 劣 ， 你 需要 熟悉 这 两 种 数据 访问 方法 。 
































m 





8.1 Java 数据 库 连 接 


Java 数据 库 连 接 (Java Database Connectivity, JDBC ) 是 Java 标准 库 的 一 部 分 ， 主 要 负责 处 
理 对 数据 库 的 访问 。 虽 然 你 可 以 使 用 纯 JDBC 代码 来 访问 数据 库 ， 但 几乎 任何 情况 下 ， 你 都 应 该 
选用 数据 框架 来 访问 数据 库 , 这 是 因为 数据 框架 很 好 地 抽象 和 封装 了 底层 细节 , 使 用 起 来 简单 又 
方便 。 不 过 ， 你 仍 需要 了 解 下 面 几 个 对 象 ， 它 们 都 在 java.sql 包 之 中 。 


O DriverManager: 实用 工具 类 ， 认 识 所 有 可 用 的 数据 库 驱 动 程序 。 

O Connection: 代表 与 数据 库 的 连接 ， 包含 URL、 用 户 名 、 密 码 等 信息 。 我 们 可 以 使 用 

DriverManager 来 创建 它们 。 

D PreparedStatement 和 CallableStatement: 把 真实 的 SQL 语句 发 送 给 数据 库 服 务 器 。 

SQL 语句 是 从 Connection 创建 的 。 

O ResultSet: 数据 返回 方式 。ResultSet 是 可 迭代 的 ， 每 个 对 象 都 代表 一 行 。 我 们 可 以 使 
用 getFoo( index) getFoo(name) 方 法 访问 数据 ， 其 中 Foo 是 数据 类 型 ， 比 如 String, 
Blob, Int 等 ，index 是 1- 列 号 ，name 指 列 名 。ResultSet 由 SQL 语句 返回 。 

O Date, Time, Timestamp: 时 间 数 据 的 SQL 表示 形式 。 


这 里 不 会 讲 太 多 细节 , 下 面 举例 说 明 如 何 使 用 原始 的 JDBC 从 一 个 数据 表 中 选取 所 有 行 并 将 
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言 息 打 印 到 控制 台 。 
//JDBC URL 告知 Java 去 何 处 找 数据 库 
String url = "jdbc:h2:mem:iscream;" + 
"DB_CLOSE_DELAY=-1 ; DB_CLOSE_ON_EXIT=FALSE"; 
// 获 取 数 据 库 连接 


try(Connection conn = DriverManager.getConnection(url, "sa", null)) ( 


String sql = "select id, ingredient, unit price from ingredient " + 


"where ingredient type - 'ICE CREAM'"; 
// 从 数据 库 连 接 创 建 SQL 5 4] 
try(PreparedStatement ps = conn.prepareStatement(sql)) { 
ResultSet rs = ps.executeQuery(); 
// 在 结果 集 上 选 代 
while(rs.next()) ( 
// 从 每 一 行 提取 值 
Integer id = rs.getInt("id"); 
String name - rs.getString("ingredient"); 
Double price - rs.getDouble("unit price"); 





String msg - String.format("ID: Xd, Name: Xs, Price 
id, name, price); 


System.out.println(msg); 


j 
当然 ， 还 有 方法 可 以 更 好 地 访问 数据 库 。 


8.2 Spring JDBC 模板 





E vis 





对 于 数据 库 使 用 , Spring 提供 了 几 种 选择 , 这 并 不 奇怪 。JdbcTemplate 类 是 最 基本 的 Spring 
JDBC 模板 ， 它 无 须 使 用 纯 JDBC 也 能 执行 SQL 语句 。JdbcTemplate 受 Datasource 支持 , 并 日 是 


























线程 安全 的 ， 这 意味 着 你 可 以 在 整个 应 用 程序 中 使 用 同一 个 实例 。 通 常 最 好 创建 一 个 Datasource 








bean， 这 样 你 就 可 以 使 用 @Autowired 来 自动 创建 JdbcTemplate 了 。 





通常 一 个 Datasource 至 少 








有 一 个 URL 和 一 个 驱动 类 名 , 根据 你 所 用 的 数据 库 服务 右 和 驱动 程 




















这 而 有 所 不 同 。 示例 采 用 了 





一 个 内 存 数据 库 一 一 H2， 其 好 处 是 示例 代码 能 够 立即 运行 。 而 在 实际 应 用 程序 中 ， 你 通常 需要 
连接 运行 有 MySql、PostgreSQL 、SQL Server 等 数据 库 的 服务 器 。 而 且 ， 在 实际 生产 环境 中 ， 
配置 连接 池 非 常 重要 ， 但 本 书 不 涉及 这 些 内 容 ， 如 果 你 感 兴趣 ， 可 访问 HikariCP Wiki”. 











(D https://github.com/brettwooldridge/HikariCP/wiki 
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这 到 底 是 什么 ? 
Spring JDBC 模板 是 一 个 轻 量 级 JDBC API 封 装 器 ， 它 抽象 了 大 量 JDBC 样板 代 
码 ， 非 常 适 于 和 Spring 依赖 注入 技术 搭配 使 用 。 


更 多 内 容 : H2 

H2 是 采用 纯 Java 编写 的 ， 并 且 运 行 速度 优先 的 标准 数据 库 服务 器 ， 它 体积 小 巧 
( 约 L5MB), 这 使 其 成 为 进行 本 地 测试 的 一 个 很 好 的 选择 。 实 际 上 ， 内 存 版 的 H2 
数据 库 运转 速度 飞快 , 使 需要 和 数据 库 打 交道 的 单元 测试 得 以 实现 , 在 构建 应 用 
程序 原型 时 ， 使 用 内 存 版 的 H2 数据 库 可 以 快速 更 改 数据 库 模式 ， 并 且 H2 带 有 
Web 控制 台 ， 可 以 在 程序 运行 时 检查 数据 。 启 用 Web 控制 台 之 后 ， 在 程序 运行 
期 间 ， 你 可 以 输入 localhost:port/h2-console 来 访问 它 。 


8.2.1 IScream 新 数据 模型 


要 让 应 用 程序 真正 成 为 数据 驱动 式 的 ， 我 们 需要 对 模型 做 些 修改 。 其 
凌 订 单 组 件 看 作 完整 的 对 象 。 本 章 要 使 用 的 数据 库 模 式 如 下 图 所 示 。 
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" ingredient | purchase | 
id; INTEGER id: INTEGER 

ingredient: VARCHAR(100) create ditm: DATETIME 

ingredient type: VARCHAR(50) bx total, price: DECIMAL(19.4) 

unit price: DECIMAL(19,4) 















purchase line item | 
id: INTEGER 

purchase id: DATETIME DO 
Xd P ingredient id: INTEGER 
units: INTEGER 





ingredient type | 
ingredient type: VARCHAR(50) 

















图 8-1 IScream 数据 库 结 构 
相应 地 ， 还 要 对 Java 类 做 一 些 改动 。 


Ingredient.java 





package com.letstalkdata.iscream.domain; 


import java.math.BigDecimal; 


e U Ne 
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public abstract class Ingredient { 
private Integer id; 
private String name; 
private BigDecimal unitPrice; 


public Ingredient(Integer id, String name, BigDecimal unitPrice) { 
this.id = id; 
this.name = name; 


this.unitPrice = unitPrice; 


public Integer getId() { 


return id; 


public String getName() { 


return name; 


public BigDecimal getUnitPrice() { 


return unitPrice; 





Flavor.java 





package com. letstalkdata.iscream.domain; 


import java.math.BigDecimal; 


public class Flavor extends Ingredient { 


public Flavor(Integer id, String name, BigDecimal unitPrice) { 


super(id, name, unitPrice); 





Topping.java 





package com. letstalkdata.iscream.domain; 


import java.math.BigDecimal; 


public class Topping extends Ingredient { 
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public Topping(Integer id, String name, BigDecimal unitPrice) { 


super(id, name, unitPrice); 





Order.java 





package com. 


import 
import 
import 
import 


public 


} 





java. 
java. 
java. 


java. 


class 


this 
this 
this 
this 


letstalk 


math.Big 
util .Arr 
util .Arr 


util.List; 


Order { 


private Flavor f 


public Order() { 


. flavor 
.Scoops 
. topping 
.totalPr 


data.iscream.domain; 


Decimal; 
ayList; 
ays; 


Mp 





avor; 


private int scoops; 
private List<Topping> toppings = new ArrayList<>(); 
private BigDecimal totalPrice; 


public Order(Flavor flavor, int scoops, Topping... 


= flavor; 

= scoops; 

s = Arrays.asList(toppings); 
ice = calculatePrice(); 


private BigDecimal calculatePrice() { 


BigDecimal iceCreamCost = flavor.getUnitPrice() 


.mul 


tiply(BigDecimal.valueOf(scoops)); 


BigDecimal toppingCost - toppings.stream() 


.map 


.reduce(BigDecimal.ZERO, BigDecimal::add); 


(Topping::getUnitPrice) 


return iceCreamCost.add(toppingCost); 


public Flavor getFlavor() ( 


return flavor; 


toppings) { 
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37 public void setFlavor(Flavor flavor) { 
38 this.flavor = flavor; 

39 } 

40 

41 public int getScoops() { 

42 return scoops; 

43 } 

44 

45 public void setScoops(int scoops) { 
46 this.scoops = scoops; 

47 } 

48 

49 public List<Topping> getToppings() { 
50 return toppings; 

54 } 

52 

53 public void setToppings(List«Topping» toppings) { 
54 this.toppings = toppings; 

55 } 

56 

57 public BigDecimal getTotalPrice() { 

58 if(totalPrice == null){ 

59 totalPrice = calculatePrice(); 
60 } 

61 return totalPrice; 

62 } 

63 ) 





8.22 ”查询 数据 





JdbcTemplate 类 提供 了 许多 查询 数据 的 方法 ， 具 体 选 择 取决 于 你 想 从 数据 库 获 取 的 数据 类 
型 。 首 先 ， 你 必须 确定 是 想 获取 一 个 还 是 多 个 “东西 ”。 然 后 ， 你 需要 确定 如 何 返 回 数据 : Java 











内 置 对 象 ( 比如 String )、 自 定义 对 象 、Map 还 是 SqlRowSet 。 这 里 使 用 自 定义 对 象 ， 





们 还 得 实现 RowMapper。 这 听 上 去 很 复杂 ,但 其 实 与 前 面 JDBC 中 循环 部 分 很 类 似 。 


IngredientService.java 


意味 着 我 





23 private RowMapper«Flavor» flavorRowMapper = (rs, rowNum) -> { 
24 Integer id - rs.getInt("id"); 

25 String name - rs.getString("ingredient"); 

26 BigDecimal unitPrice - rs.getBigDecimal("unit price"); 

27 return new Flavor(id, name, unitPrice); 


28 }; 
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把 这 个 flavorRowMapper 和 一 些 SQL 语句 结合 起 来 ， 就 可 以 从 数据 库 获得 以 Flavor 对 象 
形式 表示 的 餐 点 了 。 





IngredientService.java 





30 public List«Flavor» getFlavors() { 

31 String sql = "select id, ingredient, unit_price from ingredient " + 
32 "where ingredient type - 'ICE CREAM'"; 

33 return jdbcTemplate.query(sql, flavorRowMapper); 

34 ) 











使 用 Spring JDBC 的 好 处 在 于 ， 我 们 不 必 为 获取 数据 库 连 接 、 语 句 等 发 我， 而 只 需 关注 应 用 
程序 特有 的 “东西 >， 比如 领域 对 象 和 SQL 语句 。 


如 果 想 使 用 参数 化 的 SQL， 也 很 简单 ， 只 需 把 参数 传递 给 相应 方法 就 行 了 。 通 过 ID 获取 对 
象 的 代码 如 下 所 示 。 








IngredientService.java 





36 private static final String INGREDIENT BY ID - 

37 "select id, ingredient, unit_price from ingredient where id = ?"; 
38 

39 public Flavor getFlavorById(int id) { 

40 return jdbcTemplate.queryForObject(INGREDIENT BY ID, 

41 flavorRowMapper, id); 

42 } 





8.23 Baik 


大 多 数 时 候 , 使 用 UdbcTemplate 写 数 据 和 读数 据 一 样 简单 。 比 如 , 我 们 可 以 创建 一 个 订单 ， 
如 下 所 示 。 


final String sql = "insert into purchase(total price) values (?)"; 
jdbcTemplate.update(sql, BigDecimal.valueOf(4.25d)); 


( 令 人 困惑 的 是 ，SQL 更 新 语句 和 SQL 插入 语句 都 使 用 了 update 方法 。) 


但 请 注意 ,在 我 们 的 数据 模型 中 ,每 个 订单 都 包含 行 项 。 而且， 这 些 行 项 必须 使 用 外 键 进 行 
恰当 链接 ,为 此 ,我 们 需要 为 每 笔 交 易 加 上 ID , 并 以 此 创建 行 项 。 这 可 以 通过 Spring 的 KeyHolder 
来 实现 。 
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OrderService.java 

33 private final static String CREATE_ORDER = 
34 "insert into purchase(total_price) values (?)"; 
35 
36 private int saveOrder(Order order) { 
37 KeyHolder keyHolder = new GeneratedKeyHolder(); 
38 
39 PreparedStatementCreator psc = con -> { 
40 PreparedStatement ps = con.prepareStatement(CREATE_ORDER, 
41 PreparedStatement .RETURN. GENERATED. KEYS) ; 
42 ps.setBigDecimal(1, order.getTotalPrice()); 
43 return ps; 
44 二 
45 
46 jdbcTemplate.update(psc, keyHolder); 
47 
48 return keyHolder.getKey().intValue(); 
49 } 








通常 上 面 的 代码 能 够 正常 运行 , 但 是 如 果 保 存 过 程 中 发 生 错误 怎么 办 ? 我 们 不 希望 数据 库 中 








包含 损坏 的 或 不 完整 的 数据 .我 们 可 以 使 月 





数据 库 事 务 来 解决 这 个 问题 ,你 可 以 使 用 带 有 纯 JDBC 









































的 事务 ,但 是 Spring 提供 了 一 种 更 简单 的 方法 ， 那 就 是 eTransactional 注解 ， 你 可 以 对 事务 上 


Y 


下 文中 的 方法 添加 该 注解 。 
下 面 是 一 个 完整 的 订单 服务 ， 用 于 创 





T 











OrderService.java 


建 订单 和 行 项 。 





letsta 
letsta 
s 


import com. 


import com. 


import org.springframework. 


import org.springframework. jdbc 


jdbc 
. jdbc 
jdbc 


import org.springframework. 


import org.springframework 


import org.springframework. 


import org.springframework. 








s 
s 
s 
s 
s 
s 


import org.springframework. 


im 


port java.sql.PreparedStatement; 


@Service 
pu 
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blic class OrderService { 


.core. 


.core. 


package com.letstalkdata.iscream.service; 


kdata.iscream.domain.Ingredient; 
kdata.iscream.domain.Order; 
beans. factory.annotation.Autowired; 


JdbcTemplate; 
PreparedStatementCreator; 


.support.GeneratedKeyHolder; 

. support .KeyHolder ; 
stereotype.Service; 

transaction. annotation.Transactional; 
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private JdbcTemplate jdbcTemplate; 


GAutowired 
public OrderService(JdbcTemplate jdbcTemplate) { 
this.jdbcTemplate - jdbcTemplate; 


@Transactiona 
public void save(Order order) { 
int orderId = saveOrder(order); 
saveLineItem(orderId, order.getFlavor(), order.getScoops()); 
order .getToppings( ) 





.forEach(topping -> saveLineItem(orderId, topping, 1)); 


private final static String CREATE ORDER - 
"insert into purchase(total price) values (?)"; 


private int saveOrder(Order order) ( 
KeyHolder keyHolder - new GeneratedKeyHolder(); 


PreparedStatementCreator psc = con -> { 
PreparedStatement ps - con.prepareStatement(CREATE ORDER, 
PreparedStatement .RETURN_GENERATED_KEYS) ; 
ps.setBigDecimal(1, order.getTotalPrice()); 
return ps; 


F; 
jdbcTemplate.update(psc, keyHolder); 
return keyHolder.getKey().intValue(); 
private final static String CREATE ORDER LINE ITEM - 
"insert into purchase line item" + 
"(purchase id, ingredient id, units) values(?, ?, ?)"; 
private void saveLineItem(int orderId, Ingredient ingredient, int units) { 


jdbcTemplate.update(CREATE. ORDER. LINE, ITEM, 
orderId, ingredient.getId(), units); 








本 书 示 例 代 码 包含 IScream Web 应 用 程序 的 一 个 修改 版 本 ， 提 供 了 订单 服务 的 完整 代码 。 
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8.3 MyBatis 


与 Spring JDBC 类 似 ，MyBatis 也 依赖 于 编写 SQL。 不 过 ， 它 们 之 间 有 个 重要 的 区 别 ， 那 就 
是 MyBatis 使 用 反射 把 领域 对 象 和 数据 库 操作 更 加 紧密 地 耦合 在 一 起 。 























leq 落后 警告 : iBATIS 
MyBatis 的 前 身 是 一 个 名 为 “iBATIS” 的 老 项 目 ，2010 年 正式 更 名 为 MyBatis。 
尽管 iBATIS fe MyBatis 的 核心 理念 相同 , 但 是 它 并 不 具备 某 些 MyBatis 的 特征 。 
如 果 你 正在 使 用 iBATIS 代码 库 ， 那 么 本 节 内 容 仍然 会 对 你 有 帮助 ， 因 为 有 关 映 
射 器 的 核心 概念 是 相对 不 变 的 。 至 于 建议 , Xe: 模仿 代码 库 中 已 有 的 工 
作 模 式 。 





在 MyBatis 中 ， 在 执行 任何 操作 之 前 ， 你 需要 先 引 用 SqlSession。 而 要 创建 SqlSession， 
则 需要 用 到 SqlSessionFactory , 它 可 以 通过 SqlSessionFactoryBuilder 创建 ,大 部 分 MyBatis 
项 目的 资源 目录 下 存在 一 个 mybatis-config.xml 文件 。 该 配置 文件 包含 获取 数据 库 连 接 的 信息 ， 
可 以 传递 给 SqlSessionFactoryBuilder 来 创建 SqlSessionFactory. 我 们 应 该 为 每 个 操作 创建 
一 个 新 的 SqlSession ， 因 为 它 不 是 线程 安全 的 。 


你 也 可 以 使 用 Spring 来 完成 这 些 事 。 如 果 你 的 应 用 程序 中 有 DataSource bean, Spring 可 以 
把 SqlSession 注入 到 任何 需要 的 地 方 。Spring 创建 的 SqlSession 也 是 线程 安全 的 ， 并 且 无 须 
额外 配置 就 可 以 在 事务 中 使 用 。 


















































© 这 到 底 是 什么 ? 
MyBatis 是 一 个 使 用 反射 技术 把 SQL 自动 映射 到 服务 和 领域 对 象 的 工具 。 


8.3.1 查询 数据 


MyBatis 操作 的 主要 对 象 是 “映射 角 "。 “映射 器 ”的 作用 是 在 SQL 和 Java 对 象 之 间 进 行 转 
换 。 映 射 器 是 由 SQL 支持 的 Java 类 , 它 可 以 存储 在 XML 文件 中 或 类 自身 中 。 存 储 在 XML 中 如 
下 所 示 。 



































my-mapper.xml 





<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper 
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http: //mybatis.org/dtd/mybatis—3-mapper.dtd"> 
«mapper namespace-"com.example.service.MyMapper"» 
«select id="getEmployeeName" result-"string"» 
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select name 


8.3 MyBatis 9] 





8 from Employee 
9 where id=#{id} 
10 «/select» 


11 </mapper> 














MyMapper.java 
1 @Mapper 
2 public interface MyMapper { 
3 String getEmployeeName(@Param("id") int id); 
4 } 

或 者 仅 用 J avao 

MyMapper.java 
1 @Mapper 
2 public interface MyMapper { 
3 @Select("select name from Employee where id = #{id}") 
4 String getEmployeeName(@Param("id") int id); 
5 } 








HILF XML, 我 更 喜欢 注解 ， 但 MyBatis 是 个 例外 。XML 映射 器 提供 了 更 大 的 灵活 性 和 更 
多 选择 。 并 且 , 读 取 映射 器 文件 中 的 SQL， 并 将 其 复制 到 SQL 编辑 器 中 直接 查询 数据 库 很 容易 ， 
这 点 非常 有 用 。 









































MyBatis 的 真正 便利 之 处 在 于 ， 即 使 映射 器 只 是 接口 ， 你 也 不 必 手 动 实现 它们 ! MyBatis 会 
为 我 们 创建 默认 实现 并 启用 它们 。 当 然 ， 如 果 你 需要 提供 自 定义 行为 ， 也 可 以 自己 实现 它们 。 











Q Java: 数据 库 对 象 过 度 分 层 
在 茶 些 应 用 程序 中 ,把 服务 层 和 数据 访问 层 分 离 是 有 意义 的 。 比如， 可 能 有 一 个 
数据 访问 层 只 负责 核心 CRUD ( 创建 、 读 取 、 更 新 、 删 除 ) 操作 ,还 有 一 个 服务 
层 负责 把 操作 抽象 成 业务 概念 。 不 过 ， 有 一 种 极端 情况 ,每 层 都 有 一 个 接口 和 一 
个 实现 。 这 并 非 不 可 能 : MyServiceImpl 实现 了 MyService， 并 包含 了 一 个 对 
MyDao 的 引用 ， 而 MyDao 本 身 就 是 在 MyDaoImpl 中 实现 的 ! MyBatis 把 这 些 都 简 
化 成 对 象 ， 这 种 做 法 很 好 ， 当 然 如 果 你 确实 需要 灵活 性 ， 也 可 以 不 这 样 做 。 





前 面 提 过 ，MyBatis 可 以 更 好 地 使 用 Java 对 象 而 非 JDBC。 这 意味 着 你 可 以 把 自 定义 领域 对 
象 作为 参数 传递 到 查询 中 ， 并 接收 自 定义 领域 对 象 作 为 结果 。 下 面 这 个 映射 器 展示 了 IScream 应 
用 程序 把 flavors 和 toppings 作为 实际 对 象 返 回 的 方式 ， 这 并 不 需要 手动 映射 。 
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ingredient-mapper.xml 











1 <?xml version="1.0" encoding="UTF-8" ?> 
2 <!DOCTYPE mapper 
3 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
4 "http: //mybatis.org/dtd/mybatis—3-mapper.dtd"> 
5  «mapper namespace-"com.letstalkdata.iscream.service.IngredientService"» 
6 «select id="getFlavors" 
7 resultType="com. letstalkdata.iscream.domain.Flavor"> 
8 select id, ingredient as name, unit_price as unitPrice 
9 from ingredient 
0 where ingredient type = 'ICE CREAM' 
1 </select> 
2 «select id="getFlavorById" 
3 resultType="com. letstalkdata.iscream.domain.Flavor"> 
4 select id, ingredient as name, unit_price as unitPrice 
5 from ingredient 
6 where id = #{id} 
7 </select> 
8 «select id="getToppings" 
9 resultType="com. letstalkdata.iscream.domain.Topping"> 
20 select id, ingredient as name, unit_price as unitPrice 
21 from ingredient 
22 where ingredient type = 'TOPPING' 
23 </select> 
24 «select id="getToppingById" 
25 resultType="com. letstalkdata.iscream.domain.Topping"> 
26 select id, ingredient as name, unit_price as unitPrice 
27 from ingredient 
28 where id = #{id} 
29 </select> 
30 </mapper> 











通过 把 查询 中 的 列 和 Ingredient 类 属性 相 匹配 ，MyBatis 可 以 使 用 反射 来 自动 创建 正确 的 
对 象 并 调用 正确 的 setter 方 法 。( 你 还 可 以 使 用 自 定义 的 构造 函数 代 蔡 setter 方 法 , 但 这 需要 在 映 
射 器 文件 中 进行 一 些 额外 配置 。) 映 射 器 XML 文件 自然 就 和 Java 代码 中 的 Mapper 服务 对 象 对 应 
起 来 了 。 同 样 ， 这 不 需要 实现 。 





IngredientService.java 





package com.letstalkdata.iscream.service; 


import com.letstalkdata.iscream.domain.Flavor; 
import com.letstalkdata.iscream.domain.Topping; 
import org.apache.ibatis.annotations.Mapper; 
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import org.apache.ibatis.annotations.Param; 
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import java.util.List; 
@Mapper 
public interface IngredientService { 


List<Flavor> getFlavors(); 


Flavor getFlavorById(GParam("id") int id); 





List«Topping» getToppings(); 


Topping getToppingById(GParam("id") int id); 


OMAN ODOT AONB DO WON 
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Java 数据 类 型 和 对 象 不 仅 可 以 从 MyBatis 查询 中 返回 ， 还 可 以 传递 到 MyBatis 查询 中 。 这 使 
得 保存 、 更 新 或 删除 领域 对 象 相对 容易 。 


再 次 使 用 映射 器 文件 ， 创 建 如 下 搬入 语句 来 保存 订单 。 


purchase-mapper.xml 











<?xml version-z"1.0" encoding-"UTF-8" ?> 
«!DOCTYPE mapper 
PUBLIC "—-//mybatis.org//DTD Mapper 3.0//EN" 
"http: //mybatis.org/dtd/mybatis—3-mapper.dtd"> 
«mapper namespace-"com.letstalkdata.iscream.service.OrderService"» 
«insert id-"createPurchase" 
useGeneratedKeys-"true" 
keyColumn="id" 
keyProperty="id" 
parameterType-"com.letstalkdata.iscream.domain.Order"» 
insert into purchase (total. price) 
values(#{totalPrice}) 





</insert> 
«insert id="createPurchaseLineItem" parameterType="map"> 





insert into purchase_line_item(purchase_id, ingredient_id, units) 
values(#{purchaseld}, #{ingredientId}, #{units}) 
</insert> 
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«/mapper» 





上 面 的 代码 中 又 用 到 了 #{property} 语 法 ， 它 将 在 POJO 上 找到 匹配 的 getter 方法 ,或 者 在 
Map 中 用 作 键 。 请 注意 ,保留 交易 的 ID 很 重要 ， 我 们 可 以 在 插入 成 功 后 使 用 keyColumn 和 
keyProperty 属性 设置 POJO 上 的 ID。 
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因为 创建 订单 的 过 程 稍 复杂 ， 所 以 这 里 选择 为 交易 映射 器 提供 一 个 实现 ， 这 就 需要 访问 
SqlSession。 虽 然 这 里 选用 了 Spring， 但 请 记 住 ， 你 完全 可 以 使 用 SqlSessionFactory 手动 创 

















建 SqlSession。 
OrderService.java 
1 package com. letstalkdata. iscream.service; 
2 
3 import com. letstalkdata.iscream.domain. Ingredient; 
4 import com. letstalkdata.iscream.domain.Order; 
5 import org.apache.ibatis.annotations.Mapper; 
6 import org.apache.ibatis.session.SqlSession; 
7 | import org.springframework.beans. factory.annotation.Autowired; 
8 import org.springframework.stereotype.Service; 
9 import org.springframework.transaction.annotation.Transactional; 
0 
1 import java.util.HashMap; 
2 import java.util.Map; 
3 
4  @Mapper 
5 @Service 
6 public class OrderService { 
7 
8 private SqlSession sqlSession; 
9 
20 @Autowired 
21 public OrderService(SqlSession sqlSession) { 
22 this.sqlSession = sqlSession; 
23 } 
24 
25 @Transactional 
26 public void save(Order order) { 
27 saveOrder (order); 
28 saveLineItem(order.getId(), order.getFlavor(), order .getScoops()); 
29 order .getToppings( ) 
30 .forEach(topping -> saveLineltem(order.getId(), topping, 1)); 
31 } 
32 
33 private void saveOrder(Order order) { 
34 sqlSession.update("createPurchase", order); 
35 } 
36 
37 private void saveLineItem(int orderId, Ingredient ingredient, int units) { 
38 Map<String, Object> params = new HashMap<>(); 
39 params.put("purchaseId", orderId); 
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40 params.put("ingredientId", ingredient.getId()); 

41 params.put("units", units); 

42 sqlSession.insert("createPurchaselineItem", params); 
43 } 

44 

45 } 








请 注意 ， 上 面 的 代码 使 用 了 Spring 的 eTransactional 。 如 果 Spring 创建 了 SqlSession, 那 
么 它 可 以 自动 用 于 事务 中 。 如 果 你 不 使 用 Spring ,可 以 关闭 自动 提交 ,使 用 SqlSession.commit() 
事务 中 执行 操作 。 


B 





8.3.3 动态 SQL 


MyBatis 的 另外 一 个 重要 特性 是 它 支 持 动态 SQL。 一 个 常见 的 业务 需求 是 用 户 从 一 个 列表 中 
选择 一 个 或 多 个 项 目 ， 并 且 获 取 这 些 项 目的 相关 数据 。 为 了 访问 SQL 数据 库 ， 你 需要 编写 一 个 
where x in ... 查 询 。 有 的 开发 者 尝试 使 用 字符 串 连 接 来 实现 这 一 点 ， 结 果 使 代码 变 得 糟糕 。 
但 是 ， 这 样 的 代码 往往 包含 SQL 注入 漏洞 ， 这 通常 是 由 没有 正确 处 理 尾 随 逗 号 或 者 未 处 理 字符 
串 等 问题 引起 的 。 使 用 MyBatis 则 简单 多 了 。 


«select id-"getOrdersById" resultType-"com.letstalkdata.iscream.domain.Order"» 















































select x from purchase 
where id in 
«foreach item-"id" index-"index" collection="orderIds" 
open-"(" separator-"," close=")"> 
#{id} 
</foreach> 


</select> 
另 一 个 类 似 的 危险 行为 是 查询 时 使 用 可 选 搜索 参数 。 而 使 用 MyBatis 则 简单 多 了 。 


«select id-"findIngredientsSearch" 

















resultType="com. letstalkdata. iscream.domain. Ingredient"> 
select x from ingredient 
<where> 





<if test="name != null"> 

ingredient = #{name} 
</if> 
«if test-"type !- null"> 








and ingredient type = #{type} 
</if> 
</where> 
</select> 


XT MyBatis 动态 SQL 的 更 多 内 容 ， 可 参考 官方 文档 。 
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8.4 Hibernate 


前 面 介绍 了 MyBatis 将 POJO 领域 对 象 绑 定 到 SQL 语句 的 方法 ,但 是 人 工 编 写 这 些 相 对 基本 
的 SQL 仍然 有 些 费 事 。 此 外 ， 处 理 对 象 之 间 的 关系 也 很 麻烦 。 对 象 关 系 映射 器 CORM ) 试图 通 
过 抽象 开发 者 使 用 的 所 有 SQL 来 解决 这 些 问 题 。 理 论 上 ， 只 要 有 足够 的 对 象 信息 ， 可 以 通过 编 
程 生成 任何 SQL。 


Hibernate 是 Java 最 早 的 ORM 工具 之 一 。 几 年 后 ,JPA (Java Persistence API, Java 持久 化 标 
YE) 才 确 定 下 来 。JPA 没有 提供 任何 实现 , 而 提供 了 一 套 供 第 三 方 工具 使 用 的 公共 API。 慢 慢 地 ， 
Hibernate 成 为 了 开发 者 们 最 常用 的 第 三 方 实现 。 尽管 如 此 , 你 仍然 可 以 在 不 使 用 JPA 的 情况 下 使 
用 Hibernate。 本 章 示 例 代 码 包含 两 个 Hibernate 项 目 : 一 个 采用 了 更 时 兴 的 方式 一 一 PA 注解 ， 另 
一 个 使 用 了 XML 这 种 老 旧 的 配置 风格 。 对 于 更 复杂 的 情况 ， 你 可 以 使 用 JPA 接口 或 Hibernate 
本 地 类 与 数据 库 进 行 交 互 。 方 便 起 见 ， 注 解 代码 示例 使 用 了 JPA 接口 ， 而 XML 代码 示例 使 用 了 
Hibernate 本 地 对 象 ， 但 它们 是 可 以 混用 的 。 你 应 该 很 熟悉 这 些 内 容 ， 因 为 它们 目前 仍 在 流行 。 




































































8.4.1 领域 POJO 调整 


使 用 ORM 时 ， 领 域 对 象 和 数据 库 越 匹配 ， 需 要 做 的 工作 就 越 少 。 虽 然 它 处 理 抽 象 类 完全 没 
问题 ( 比如 包含 Flavor Fil Topping 类 的 ingredient 表 ), 但 这 里 不 讲述 相关 细节 ， 以 免 混 淆 你 
对 IPA 的 理解 。 下 面 我 们 修改 领域 对 象 以 匹配 数据 表 。 





图 8-2. IScream 领域 对 象 
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8.4.2 JPA 注 解 


JPA 提供 了 一 套 标记 领域 类 的 注解 ， 用 于 描述 这 些 类 映射 到 底层 数据 库 的 方式 。 通 常 ， 类 的 
注解 是 @Entity flleTable(name = "myDatabaseTableName" ) ， 而 属性 的 注解 是 ecolumn(name = 
"myColumnName" ) 。 当 然 ， 我 们 也 可 以 向 特定 列 添加 注解 ， 比 如 ID 列 和 外 键 列 。 重 要 的 是 ， 外 
键 并 不 表示 为 整数 ， 而 表示 为 对 象 本 身 。 例 如 ，orderLineItem 类 没有 purchase id 属性 , 它 
有 一 个 order 属性 。 


OrderLineItem 类 的 属性 的 完整 注解 如 下 所 示 。 




















OrderLineltem.java 
10 erd 
11 @Column 
12 @GeneratedValue(strategy = GenerationType. IDENTITY) 
13 private Integer id; 
14 
15 @ManyToOne( fetch = FetchType.LAZY) 
16 @JoinColumn(name = "purchase id") 
TT private Order order; 
18 
19 @ManyToOne( fetch = FetchType.LAZY) 
20 @JoinColumn(name = "ingredient id") 
21 private Ingredient ingredient; 
22 
23 GColumn(name - "units") 
24 private Integer units; 








上 面 的 代码 中 ， 我 们 关注 两 个 外 键 属性 ， 首 先 eJoincolumn 注解 表示 相关 属性 用 于 SQL xt 
接 ，@ManyToone 表示 多 对 一 关系 ， 因为 每 个 Order 都 有 多 个 OrderLineItems 。fetch = 
FetchType.Lazy 指示 Hibernate ( 准确 地 说 ， 所 使 用 的 任何 JPA Provider ) 不 加 载 真实 的 Order 
对 象 , 除非 有 明确 请 求 。FetchType.Eager 与 FetchType.Lazy 相反 , 它 表 示 只 要 OrderL ineItem 
从 数据 库 返 回 就 加 载 Order。 


下 面 在 订单 和 其 行 项 之 间 创 建 一 个 双向 关系 ,当然 并 非 必须 这 么 做 。 对 Order 属性 的 注解 如 
下 所 示 。 























Order.java 
14 erd 
15 @Column 
16 @GeneratedValue(strategy = GenerationType. IDENTITY) 


17 private int id; 
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18 

19 GOneToMany(mappedBy = "order", cascade = CascadeType.ALL) 

20 private List<OrderLineItem> orderLineItems; 

21 

22 GColumn(name - "create dttm") 

23 private Timestamp created - Timestamp.valueOf(LocalDateTime.now()); 
24 

25 GColumn(name - "total price") 

26 private BigDecimal totalPrice; 





上 面 的 代码 中 出 现 了 新 注解 60neToMany ， 它 表示 一 对 多 的 关系 ， 即 一 个 order 对 应 多 个 
OrderLineItems。mappedBy 属性 告诉 Hibernate 返回 OrderLineItems 时 应 该 使 用 order 查找 
setter 方法 ， 比 如 返回 OrderLineltems 时 为 setOrder, ， 而 cascade 属性 用 于 描述 当 父 对 象 发 生 操 
作 时 子 对 象 的 行为 。CascadeType .ALL 表示 针对 一 个 order 的 更 新 、 插入、 删除 操作 也 会 级 联 到 
其 子 对 象 OrderL ineItems。 


IPA 中 有 很 多 描述 数据 库 中 各 种 关系 的 注解 。 更 多 内 容 ， 可 参见 IPA JavaDoc’, 

















o EZAR: JPA 实现 
虽然 Hibernate 是 目前 最 流行 的 IPA 实现 ， 但 并 不 是 唯一 一 个 。 其 他 主要 的 实现 
还 有 EclipseLink 和 OpenJPA。 所 有 这 些 实现 都 有 自己 的 注解 ， 提 供 了 IPA 所 不 
具备 的 一 些 高 级 特性 。 虽 然 通 常 首 选 Hibernate， 但 如 果 你 需要 用 到 某 个 特性 ， 
也 可 以 选用 其 他 JPA 实现 。 














在 使 用 IPA 时 ， 我 们 通常 使 用 persistence.xml 文件 或 者 通过 Java 编程 的 方式 配置 Hibernate。 
请 注意 ， 这 两 种 方法 并 非 某 个 JPA Provider 专 有 ， 即 你 可 以 在 其 他 JPA Provider 中 使 用 它们 。 更 
多 细节 ， 请 阅读 官方 文档 的 “Bootstrapping” 部 分 。 最 后 ， 如 果 你 使 用 的 是 Spring Boot， 大 部 分 
时 候 配置 都 是 application.yml / application.properties 中 的 几 个 值 自动 设 定 的 。 




































































8.4.3 XML 映射 


在 Hibernate 中 ， 有 一 种 映射 对 象 的 老 办 法 ， 那 就 是 使 用 XML。 应 用 程序 中 每 个 实体 类 都 有 
一 个 MyClassName.hbm.xml 文件 ， 并 且 这 个 文件 要 在 类 路 径 上 。 每 个 文件 都 列 出 了 相应 类 的 属 
性 (比如 <property ...) 及 其 关系 (比如 cone-to-many ... )。 下面 两 个 XML 分 别 是 Order 
和 OrderLineItem 的 映射 。 如 果 把 它们 和 IPA 注解 类 进行 比较 ， 就 会 发 现 它们 使 用 的 术语 和 结 
构 是 类 似 的 ， 当 然 一 些 用 词 是 不 一 样 的 。 











Pan! 





























(D http://docs.oracle.com/javaee/7/api/javax/persistence/package-summary.html 
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Order.hbm.xml 





<?xml version-z"1.0" encoding="utf-8"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN" 
"http://www. hibernate. org/dtd/hibernate-mapping-3.9@.dtd"> 


«hibernate-mapping» 
«class name-z"com.letstalkdata.iscream.domain.Order" table="purchase"> 
«id name="id" type="int" column="id"> 
<generator class="identity"/> 
«/id» 
«property name="created" column="create_dttm" type="timestamp"/> 
<property name="totalPrice" column="total_price" type="big_decimal"/> 
«bag name="orderLineItems" 
table="purchase_line_item" 
cascade-"all" 
inverse="true"> 
«key column="purchase_id" not-null-"true" /> 
«one-to-many class="com. letstalkdata.iscream.domain.OrderLineItem"/> 
</bag> 
</class> 
«/hibernate-mapping» 





OrderLineltem.hbm.xml 





<?xml version-z"1.0" encoding-"utf-8"?» 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN" 
"http://www. hibernate. org/dtd/hibernate-mapping-3.@.dtd"> 


«hibernate-mapping» 
«class name="com.letstalkdata.iscream.domain.OrderLineItem" 
tablez"purchase line item"» 

«id name="id" type="int" columnz"id"» 

«generator class-"identity"/» 

«/id» 

«many-to-one name="order" 
class-"com.letstalkdata.iscream.domain.Order" 
lazy="proxy" 
fetch="join"> 

«column name="purchase_id" not-null="true" /> 

«/many-to-one» 

«many-to-one name="ingredient" 
classz"com.letstalkdata.iscream.domain.Ingredient" 
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20 lazy="proxy" 
21 fetch="join"> 
22 «column name="ingredient_id" not-null-"true" /> 
23 «/many-to-one» 
24 «property name="units" column="units" type="int"/> 
25 </class> 
26 </hibernate-mapping> 








使 用 映射 时 ， 你 必须 通过 配置 把 它们 注册 到 Hibernate。 大 多 数 情 况 下 ， 你 都 可 以 使 用 Java 

















编程 方式 、hibernate.properties 文件 或 hibernate.cfg.xml 文件 配置 Hibernate。 有 关 Hibernate 配置 


的 更 多 细节 ， 可 阅读 官方 文档 的 “Legacy Bootstrapping” 部 分 。 
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. JPA 








可 以 想见 ，JPA 的 OrderService 和 之 前 见 到 的 有 很 大 不 同 。JPA 中 ，EntityManager 对 象 
承担 着 重要 工作 。 与 MyBatis 类 似 ， 获 取 EntityManager 的 一 个 方法 是 通过 EntityManager 


Facto 


merge 






































ryBuilder > EntityManagerFactory > EntityManager. EntityManager 有 persist、 
. remove 三 种 方法 ， 大 致 对 应 “插入 ”“ 更 新 ”“ 删 除 ”™。 

















下 面 的 代码 很 好 地 体现 了 ORM 的 强大 之 处 ， 即 无 须 编写 SQL, 而 只 使 用 注解 ，JPA Provider 
就 能 执行 正确 的 插入 操作 ,保存 Order 和 orderLineItems。 这 意味 着 只 用 一 行 代码 即 可 保存 一 























个 对 象 ! 

OrderService.java 
20 @Transactional 
21 public void save(Order order) { 
22 entityManager .persist(order); 
23 } 
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. 原生 Hibernate 








RAHA IPA, AKRE LEM Hibernate 中 的 SessionFactory 创建 Session, Hibernate 中 ， 




















每 个 工作 单元 就 是 一 个 Session。“ 工 作 单元 ”这 个 词 有 点 含糊 不 清 ， 通 常 一 个 工作 单元 比 一 次 
数据 库 访问 稍 大 ,可 能 包含 几 个 紧密 相关 的 操作 。 例 如 ，Web 应 用 程序 中 一 次 用 户 请 求 就 是 一 个 





工作 








元 。 
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persit 方 法 和 merge 方 法 有 点 复杂 ，StackOverflow 上 有 个 回答 详细 讲解 了 它们 之 间 的 不 同 。 
( https://stackoverflow.com/questions/1069992/jpa-entitymanager-why-use-persist-over-merge ) 
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除了 merge WIE. persist 方法 之 外 ，Hibernate 会 话 还 包括 save, update, saveOrUpdate 
等 操作 。 然 而 这 些 方法 有 点 复杂 。 关 于 这 些 方法 的 讨论 ， 可 前 往 Baeldung [iit “Hibernate: save, 
persist, update, merge, saveOrUpdate" 。 


使 用 原生 Hibernate 保存 对 象 的 代码 相对 较 短 ， 但 是 要 记得 关闭 Session ( 自动 关闭 )。 











OrderService.java 
20 public void save(Order order) { 
21 try(Session session = sessionFactory.openSession()) { 
22 Transaction tx - session.beginTransaction(); 
23 session.persist(order); 
24 tx.commit(); 
25 } //Session 自动 关闭 
26 } 





8.4.5 ”读数 据 


使 用 ORM 时 ,“ 保 存 对 象 ”相对 简单 ， 因 为 对 象 有 注解 ， 但 “获取 对 象 ”就 不 那么 容易 了 。 
你 要 考虑 使 用 什么 样 的 过 滤器 , 想 获取 一 个 还 是 多 个 对 象 ， 是 否 包 含 子 对 象 等 问题 。 为 此 , 我 们 
需要 构建 一 个 查询 。 

对 此 ，Hibernate 提供 了 几 种 选择 ， 比 如 使 用 Criteria 对 象 、 编 写 HQL (Hibernate Query 


Language )、 编 写 原生 SQL (通常 尽量 避免 使 用 原生 SQL， 因 为 与 ORM 框架 的 初 囊 相悖。 但 是 
在 某 些 情况 下 是 不 可 避免 的 ) 下 面 比较 三 种 方法 。 




































































Criteria 


private List«Ingredient» getIngredients(Ingredient.Type type) { 
CriteriaBuilder cb - entityManager.getCriteriaBuilder(); 
CriteriaQuery«Ingredient» criteriaQuery - 

cb.createQuery(Ingredient.class); 

Root ingredient - criteriaQuery.from(Ingredient.class); 
criteriaQuery.where(cb.equal(ingredient.get("type"), type)); 
TypedQuery«Ingredient» query - entityManager.createQuery(criteriaQuery); 
return query.getResultList(); 

j 


HQL 


private List«Ingredient» getIngredients(Ingredient.Type type) { 
String hql = "select i from Ingredient i where type -:type"; 
Query query = entityManager.createQuery(hql); 
query.setParameter("type", type); 
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@SuppressWarnings("unchecked") 
List«Ingredient» ingredients = 

(List«Ingredient») query.getResultList(); 
return ingredients; 


} 
原生 SQL 


private List<Ingredient> getIngredients(Ingredient.Type type) { 
String sql = "select «x from ingredient where ingredient type = ?"; 
Query query = entityManager.createNativeQuery(sql, Ingredient.class); 
query.setParameter(1, type.name()); 
@SuppressWarnings( "unchecked" ) 
List«Ingredient» ingredients = 
(List«Ingredient») query.getResultList(); 
return ingredients; 


} 
如 果 你 使 用 原生 Hibernate 代替 JPA, 那 要 编写 的 代码 大 致 一 样 ,但 有 一 点 不 同 , 那 就 是 Query 


是 org.hibernate.Query， 而 非 javax.persistence.Query， 它 由 Session.createQuery() 


对 于 上 面 三 种 方法 ,如 何 选择 并 非 总 是 易 事 。 前 面 讲 过 , 应 当 尽 量 避 免 使 用 原生 SQL， 因 为 
会 使 得 Hibernate 无 法 进行 检查 ,也 许 你 会 说 :“ 相 信 我 ,我 知道 自己 在 干什么 , 你 只 要 执行 SQL 
就 好 了 !” 不 过 ， 要 使 用 原生 SQL 最 好 还 是 有 合适 的 理由 。 如 果 查 询 很 复杂 ， 或 者 要 获取 的 数据 
并 未 映射 到 Entity, 那 最 好 选用 原生 SQL. 而 criteriaBuilder 能 够 让 你 无 须 使 用 SQL 便 获 取 
数据 , 并 且 完 全 是 类 型 安全 的 , 但 缺点 是 相当 烦琐 ,而 且 难 以 阅读 。 我 使 用 HQL 最 多 , 它 和 SQL 
类 似 ， 又 比 Criteria 易 读 ， 但 代价 是 牺牲 了 一 点 类 型 安全 。 




















































































































8.5 小 结 


很 多 Java 应 用 程序 都 要 跟 数据 库 打 交道 , 而 Java 标准 库 只 提供 了 最 基本 的 数据 库 连 接 工具 。 
虽然 有 些 代 码 库 仍 然 依赖 于 纯 JDBC， 但 现在 有 大 量 成 熟 的 框架 可 使 用 ， 恰 当地 选用 这 些 框架 能 
简化 应 用 程序 与 数据 库 的 交互 。 


Spring JDBC 在 JDBC 基础 上 提供 了 一 些 更 易 用 的 功能 ， 但 是 它 仍然 需要 我 们 手动 在 领域 对 
KA SQL 之 间 进 行 转换 。 而 在 MyBatis 中 ， 大 部 分 转换 都 是 自动 进行 的 ， 并 且 支 持 把 SQL 存储 
在 代码 外 部 。 最 后 ，Hibernate 试图 抽象 开发 者 用 到 的 所 有 SQL ( 或 者 说 至 少 大 部 分 )。 现 在 大 部 
分 Hibernate 项 目 都 会 使 用 JPA 注解 ， 但 一 些 老 项 目 可 能 仍 在 使 用 XML 映射 。 


id, 人 们 讨论 的 最 多 的 是 哪 种 数据 方案 最 好 。 而 实际 上 , 同一 个 问题 往往 有 多 种 解决 方法 ， 
并 且 有 时 这 些 方法 效果 相近 。 所 以 ， 了 解 不 同 的 解决 方法 很 重要 ， 说 不 定 哪 天 就 会 用 到 它们 。 
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当初 Java 发 布 时 , 其 标准 库 中 并 不 包含 任何 日 志 专 用 API。 开发 者 只 能 使 用 System.out .println 
RI System.err.printin 打印 日 志 。 有 些 人 觉得 这 足够 了 ,但 是 绝 大 数 情况 下 对 日 志 有 更 多 控制 
都 是 好 事 。 因 此 ，Log4 框架 在 21 世纪 初 流行 起 来 。 几 年 后 ，Java 终于 在 标准 库 中 添加 了 日 志 
API (JUL, java.util.logging ), 但 是 这 套 API 有 很 多 不 足 ， 因 此 很 多 人 仍然 使 用 Log4j。 这 
使 得 JUL 开发 者 们 处 在 一 个 困境 之 中 ， 他 们 要 兼顾 JUL 用 户 和 Log4j 用 户 。 


这 个 问题 的 解决 方案 是 使 用 日 志 门 面 (loggig facade )， 这 促成 了 Apache Commons Logging 
和 简单 日 志 门 面 ( SLFA4J, simple logging facade ) 的 产生 。2006 年 ， 另 一 个 框架 Logback 也 取得 
了 一 些 进展 。( 顺便 提 一 下 ,Log4j、SLF4J 和 Logback 的 开发 者 都 是 Ceki Gulcu。 ) 这 些 努 力 让 开 
发 者 可 以 在 Java 中 轻松 生成 日 志 ， 值 得 称 赞 。 它 们 为 我 们 提供 了 不 同 选择 和 组 合 的 可 能 ， 同 时 
也 带 来 了 一 些 令 人 困惑 和 头疼 的 问题 ， 让 某 些 原本 极其 简单 的 事情 变 得 复杂 起 来 。 













































































9.1 java.util.Logging 








相 较 于 第 三 方 实现 ， 使 用 标准 库 中 的 实现 往往 是 更 明智 的 选择 ， 所 以 JUL 就 成 了 不 二 之 选 。 
为 了 配置 日 志 记 录 器 (logger )， 我 们 需要 创建 一 个 logging.properties 文件 ， 并 且 要 把 JVM 属性 
java.util.logging.config.file 设置 成 配置 文件 的 路 径 。 不 同类 型 的 日 志 处 理 器 (handler ), 
配置 选项 也 不 同 。 日 志 处 理 器 是 日 志 消 息 的 一 个 常规 目的 地 , 比如 Filehandler、SocketHandler 
等 。 每 个 处 理 器 的 配置 选项 都 不 同 ,你 可 以 在 相应 的 JavaDoc ( 比如 FileHandler ) 中 找到 它们 。 
下 面 的 配置 示例 代码 用 于 把 日 志 数 据 发 送 到 文件 和 标准 输出 。 












































logging.properties 





## VM 参数 java.util.logging.config. file 必须 指向 这 个 文件 


.level = WARN 
com.letstalkdata.level = FINE 


O J B5 WON EF 


handlers - java.util.logging.FileHandler, java.util.logging.ConsoleHandler 
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java.util.logging.FileHandler.level 
java.util.logging.FileHandler.append 
java.util.logging.FileHandler.pattern 
java.util.logging.FileHandler.formatter 


java.util.logging.ConsoleHandler.level 


OD OO CO A 














java.util.logging.SimpleFormatter.format - 


java.util.logging.ConsoleHandler.formatter 


[41$tc] X4$s: %2$s - X5$s %6$s%n 


WARNING 
true 


ISCream.%u.%g.log 


java.util.logging.SimpleFormatter 


FINE 


java.util. logging.SimpleFormatter 





Eni f SP RES T OS BIRMIE BE qi BAS TF] BM ITT IE o DA a Bl, RREAN WARN , 





而 com. letstalkdata HiX HW FINE, 这 指 





定 了 所 人 允许 的 日 志 级 别 。 然 后 , 我 们 配置 各 个 处 理 需 : 





FileHandler 的 级 别 设置 为 WARNING, 表示 它 会 把 Warning 及 更 高 级 别 的 日 志 发 送 到 一 个 文件 中 ; 
ER E He 
für E). SUB ES, BRUM Pan MAS, BAAR. HA, MRE TOR d 
(rootlogger) 设置 为 INFO0， 你 应 该 会 看 到 一 些 Hibernate 日 志 语 句 。 


接 下 来 ， 我 们 为 每 个 要 生成 日 志 消息 的 类 创建 java.util.1ogging.Logger。 为 了 让 特定 包 
的 日 志 配 置 起 作用 ， 我 们 在 命名 Logger 时 应 该 使 用 完整 的 类 名 。 











如 下 所 示 。 


OrderService.java 























import javax.persistence.EntityManager; 


import javax.transaction.Transactional; 


import java.util.logging.Logger; 


@Service 





public class OrderService { 


private static final Logger log = 


@PersistenceContext 


private EntityManager entityManager ; 


(X O -10 Ol d C ND 7^ ODO AWANAN DAF WON KE 





package com.letstalkdata.iscream.service; 


import com.letstalkdata.iscream.domain.Order; 


import javax.persistence.PersistenceContext; 


import org.springframework.stereotype.Service; 


Logger . getLogger (OrderService.class.getPackage().getName()); 
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20 public OrderService(){} 

21 

22 @Transactional 

23 public void save(Order order) { 

24 log.fine("Trying to save order."); 
25 entityManager.persist(order); 

26 } 

27 

283 } 











JDK 日 志 API 有 点 复杂 , 其 主要 方法 有 两 种 : Logger. level(String message) (其中, level 
Æ severe warning,info 等 中 的 一 个 ) 和 Logger.1og(Level level, String message, Object [] 
parameters)。 下 面 展 示 它 们 的 用 法 。 



































OrderService.java 
22 @Transactional 
23 public void save(Order order) { 
24 log.fine("Trying to save order."); 
25 entityManager.persist(order); 
26 } 
OrderMaker.java 
32 public void makeRandomOrder() { 
33 List«Ingredient» flavors - ingredientService.getFlavors(); 
34 List«Ingredient» toppings - ingredientService.getToppings(); 
35 Ingredient myFlavor = getRandom(flavors, 1).get(0); 
36 List«Ingredient» myToppings - getRandom(toppings, 3); 
37 myToppings.add(myFlavor); 
38 
39 Order order - new Order(toppings, 1); 
40 orderService.save(order); 
41 log.log(Level.INFO, "Saved Order ID {@}!", order.getId()); 
42 } 








运行 上 面 的 示例 代码 , 日 志 信息 会 转 存 到 控制 器 和 一 个 文件 中 。 另 外 , 特意 制造 了 一 个 错误 ， 
这 样 你 就 能 看 到 异常 是 如 何 记录 的 。 





9.2 Log4j 


Log4j 是 最 早 的 第 三 方 Java 日 志 框架 之 一 ， 现 在 仍然 广 受 欢迎 。Log4j 有 两 个 主要 概念 : 附 
加 器 ( appender ) 和 日 志 记 录 器 。 附加 器 是 日 志 输 出 目的 地 , 负责 指明 日 志 输 出 位 置 , 比如 stdout, 
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文件 、 数 据 库 等 。 日 志 记 录 器 负责 收集 日 志 信息 ， 并 把 它们 发 送 到 一 个 或 多 个 附加 器 。 


Log4j 通过 XML, JSON, YAML 或 属性 文件 来 配置 。 这 些 文件 的 结构 一 样 ， 但 是 语法 明显 
不 同 。 示 例 选 用 了 YAML, 但 请 注意 , 它 可 以 轻松 转换 成 其 他 任意 格式 。 配 置 的 第 一 部 分 用 于 设 
置 总 体 属性 。 这 里 ， 最 重要 的 是 保存 在 format 属性 中 的 模式 。 









































log4j2.yml 





Configuration: 
status: warn 
name: IScream 


properties: 


name: format 
value: "[%5p] Xd %c{1.} [9t] %m%n" 
thresholdFilter: 


1 
2 
3 
d 
5 property: 
6 
7 
8 
9 level: debug 








o 更 多 内 容 : Log4 日 志 输 出 格式 

Log4j 日 志 输 出 格式 看 上 去 让 人 眼花 线 乱 ， 从 零 开 始 编写 不 可 取 。 你 应 该 使 用 公 
司 制定 的 标准 日 志 输 出 格式 。 当 然 ， 如 果 你 确实 需要 调整 日 志 输 出 格式 ， 可 以 查 
阅 Pattern Layout 文档 。 
提示 : 日 志 输 出 格式 很 容易 就 写 得 过 于 复杂 ， 寻 致 代价 高 昂 。Pattern Layout © 
档 提 到 了 一 些 会 导致 高 昂 代 价 的 “东西 ">， 比 如 日 志 语 名 的 文件 、 方 法 、 行 等 。 
除非 你 确实 需要 ， 否 则 不 要 使 用 它们 。( 请 记 住 ， 栈 跟踪 会 提供 错误 的 完全 限定 
类 名 和 行 号 。) 


接 下 来 ， 我 们 定义 两 个 附加 器 ， 一 个 是 控制 台 附 加 器 ， 负 责 把 日 志 输 出 到 stdout; 另 一 个 
是 滚动 日 志文 件 附 加 器 ， 负 责 把 日 志 写 到 iscream. logo Log4j 提供 了 大 量 不 同类 型 的 附加 器 ， 
可 满足 你 的 各 种 需求 。 























log4j2.yml 





appenders: 
Console: 
name: STDOUT 
PatternLayout: 
Pattern: ${format} 
RollingFile: 
name: File 





aN OF WN H 


fileName: iscream.log 
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19 filePattern: iscream-Zd(yyyy-MM-dd]-£i.1log 
20 defaultRolloverStrategy: 
21 max: 10 

22 policies: 

23 sizeBasedTriggeringPolicy: 

24 size: 1 MB 

25 PatternLayout: 

26 Pattern: ${format} 
Bn, MEAW Kár 
log4j2.yml 

29 Loggers: 

30 Root: 

31 level: error 

32 AppenderRef: 

33 - 

34 ref: STDOUT 

35 ref: File 

36 

37 logger: 

38 - 

39 name: com.letstalkdata 

40 level: debug 

41 additivity: false 

42 AppenderRef: 

43 i 

44 ref: STDOUT 

45 level: debug 

46 - 

47 ref: File 

48 level: warn 




















所 有 Log4j XPF M—TMiRic eat (root logger ), iB 








ides. Tae FAR: 如 果 根 据 类 名 来 命名 记录 顺 ， 你 可 以 在 包 级 别 控制 日 志 。 如 





常 还 要 为 项 目 本 身 定 义 一 个 自 定 义 


FH 
IN 








你 需要 在 不 同 级 别 对 应 用 程序 的 不 同 层 做 日 志 记 录 , 或 者 想 调 试 第 三 方 代码 ， 这 会 非常 有 用 。 这 
个 特定 配置 会 把 调试 (或 高 于 调试 的 ) 语句 直接 从 com.letstalkdata 输出 到 stdout ， 把 警告 
(或 高 于 警告 的 ) 语句 从 com.1etstalkdata 输出 到 stdout 和 iscream.log, 把 错误 (或 高 于 错 





误 的 ) 语句 从 所 有 包 输 出 到 stdout 和 iscream.1og。 与 JUL 
看 看 这 些 改动 对 日 志 记 录 产 生 的 影响 。 


m^ 

















示例 一 样 ， 建 议 你 动手 修改 设置 ， 








1 


10 第 9 章 日 志 





15 


22 
23 
24 
25 
26 

















日 志 记 录 的 代码 和 JUL 语法 类 似 。 YE Log4j F, 我 们 使 用 org. apache. 1ogging.1094j .LogManager 





OrderService.java 


^E AY org. apache. logging. 1log4j.Loggers. 





private static final Logger log = LogManager.getLogger(OrderService.class); 





写 日 志 的 语法 稍微 简单 一 点 。 日 志 级 别 的 方法 有 : trace, debug, info, warn, error 和 fatal. 
这 些 方法 也 包含 了 大 量 记录 异常 (Throwables ) 的 选项 ， 以 及 参数 化 日 志 消 息 。 


OrderService.java 





@Transactional 


public void save(Order order) { 


log.debug("Trying to save order."); 


entityManager .persist(order); 





OrderMaker.java 





public void makeRandomOrder() { 


List«Ingredient» flavors = ingredientService.getFlavors(); 


List«Ingredient» toppings - ingredientService.getToppings(); 


Ingredient myFlavor 


- getRandom(flavors, 1).get(0); 


List«Ingredient» myToppings - getRandom(toppings, 3); 


myToppings.add(myFlavor); 


Order order - new Order(toppings, 1); 


orderService.save(order); 


log.info("Saved Order ID {}!", order.getId()); 


public void makeBadOrder() { 


try ( 


Order order - new Order(); 


orderService.save(order); // 本 行 用 于 触发 错误 


} catch (PersistenceException e) { 


log.error("Error saving order!", e); 
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lad 落后 警告 : Log4j1 
2014 年 ，Log4j 发 布 了 一 个 向 后 不 兼容 的 版 本 2。 尽 管 Log4j2 包含 了 许多 改进 ， 
但 是 其 兼容 性 问题 导致 应 用 程序 和 示例 有 可 能 出 现 “Log4j1”。 虽 然 迁 移 相 对 容 
A, MAMTA SIR, 我 们 通常 遵循 “ 没 问 题 就 不 动 它 ” 的 原则 。 最 值得 注意 
的 是 ，Log4jl 的 配置 文件 看 起 来 有 所 不 同 。 本 书 示 例 代码 包含 一 个 Log4jl HA 
示例 ， 其 项 目 日 志和 Log4j2 项 目 几 乎 完全 一 样 。 


9.3 Logback 


关于 Logback, 其 官方 文档 写 到 : Logback 旨 在 成 为 流行 的 Log4j 的 继承 者 。 尽管 Log4j 广 受 
欢迎 ,但 是 多 年 的 检验 发 现 其 存在 许多 问题 。 因 此 ，Log4j 的 创建 者 决定 重 写 一 个 日 志 框 架 ， 这 
就 是 Logback。Logback 1.0.0 在 2011 年 就 推出 了 ,但 是 直到 最 近 几 年 ， 人 们 才 开 始 大 量 使 用 它 。 

配置 Logback 时 ,我 们 可 以 使 用 logback.xml 文 件 或 1oback.groovy 文 件 。 与 Log4j 一 样 ,Logback 


中 也 有 附加 器 和 记录 器 的 概念 , 并 且 大 部 分 术语 都 是 相似 的 。 下 面 的 配置 文件 负责 把 日 志 输出 到 
控制 全 和 滚动 文件 中 。 







































































logback.xml 





<?xml version-z"1.0" encoding="UTF-8"?> 
<configuration> 
«property name="format" value-"[X5p] %d %c{35} [Xt] %m%n"/> 


«appender name="STDOUT" class-"ch.qos.logback.core.ConsoleAppender"» 
«layout class="ch.qos.logback.classic.PatternLayout"> 
«Pattern»$[format]«/Pattern» 
</layout> 
</appender > 


<appender name="FILE" 
class="ch.qos.logback.core.rolling.RollingFileAppender"> 
<file>iscream. log</file> 
«encoder class="ch.qos.logback.classic. encoder .PatternLayoutEncoder"> 
<Pattern>${ format} </Pattern> 
«/encoder» 


«rollingPolicy 


(* O -10 Ol 9 CO ND c^ GG (0-10 0i d 0 M FE 





class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy"> 


N 
© 


<fileNamePattern>iscream.%i.log.zip</fileNamePattern> 


N 
nie 


«minIndex»1«/minIndex» 


N 
N 


<maxIndex>10</maxIndex> 


N 
CD 


«/rollingPolicy» 
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24 «triggeringPolicy 

25 class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy"> 
26 «maxFileSize»10MB«/maxFileSize» 

27 </triggeringPolicy> 

28 

29 </appender > 

30 

31 «root level="ERROR"> 

32 «appender-ref ref="STDOUT"/> 

33 «appender-ref ref="FILE"/> 

34 «/root» 

35 

36 «logger level="DEBUG" name="com.letstalkdata" additivity-"false"» 
3T «appender-ref ref="STDOUT"/> 

38 </logger> 


39 </configuration> 








Logback 的 日 志 输 出 格式 和 Log4j 很 相似 ， 但 更 易 使 用 。 比 如 使 用 xc 时 ,你 可 以 指定 需要 的 
长 度 ，Logback 还 能 智能 地 对 包 进 行 缩写 ， 以 满足 所 需 长 度 。 


Logback 与 之 前 的 日 志 框 架 最 大 的 不 同 是 ， 它 并 未 提供 自己 的 日 志 记录 API， 而 是 依赖 于 
SLF4J 门面 API。 也 就 是 说 ,在 代码 中 ， 我 们 要 使 用 org.slf4j.LoggerFactory 来 创建 
org.slf4j.Loggers。SLF4J 应 用 很 广泛 ,不 只 用 于 Logback， 还 应 用 于 其 他 各 种 日 志 系 统 ， 下 
面 详细 介绍 。 














9.4 SLF4J 


开发 Java 库 时 ， 我 们 会 遇 到 一 个 问题 ， 那 就 是 做 日 志 记 录 时 如 何 实现 既 提 供 有 用 信息 又 不 
太 麻 烦 。 直 接 写 到 STDOUT 显然 很 麻烦 ， 我 们 应 该 选择 一 个 日 志 提供 器 并 且 强 制 库 的 用 户 配 置 
它 。 解 决 方案 就 是 使 用 日 志 门 面 。 






































o 这 到 底 是 什么 ? 

正确 配置 之 后 ，SLF4J 就 成 为 所 有 日 志 的 前 端 。 库 和 客户 代码 通过 SLF4J API 把 
日 志 发 送 到 SLF4J]， 而 后 SLF4J 在 内 部 把 日 志 消 息 发 送 给 所 选择 的 日 志 提 供 器 ， 
比如 Log4j、JUL 等。 





虽然 日 志 门 面 学 起 来 有 点 难 ， 但 它 会 让 日 志 记 录 工 作 变 得 简单 。SLF4J API 也 很 好 用 。 


使 用 SLF4J 时 ， 你 需要 一 个 “ 绑 定 器 ”( binder ) 来 在 SLF4J 和 日 志 提 供 器 之 间 进 行 转 换 。 
示例 代码 使 用 了 Log4j ， 这 意味 着 要 引入 log4j-slf4j-impl 绑 定 器 。 也 就 是 说 ， 我 们 要 用 到 四 
个 依赖 项 : SLF4J APIs1f4j-api ( 和 绑 定 器 打交道 )、1og4j-slf4j-impl (用 于 发 送 日 志 消 息 给 
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Log 4j 1og4j-core ), Log4j 1og4j-core 和 Jackson jackson-dataformat-yaml ( 用 于 配置 Log 





4j 10og4 j-core ). 





9.3 节 提 到 过 ， 我 们 使 用 SLF4J 的 LoggerFactory 创建 记录 器 实例 。 





OrderService.java 
15 private static final Logger log = 
16 LoggerFactory.getLogger(OrderService.class); 








Log4j 的 六 种 日 志 级 别 有 五 种 可 以 用 于 SLFAJ: trace, debug, info, warn 和 error, FI Log4j 
一 样 ， 在 Logback 中 这 些 日 志 级 别 都 有 相应 的 方法 ， 并 且 带 有 许多 选项 ， 用 于 传人 参数 或 异常 
(Throwable )。 














OrderService.java 
23 @Transactional 
24 public void save(Order order) { 
25 log.debug("Trying to save order."); 
26 entityManager.persist(order); 
21 } 
OrderMaker.java 
31 public void makeRandomOrder() { 
32 List«Ingredient» flavors - ingredientService.getFlavors(); 
33 List«Ingredient» toppings - ingredientService.getToppings(); 
34 Ingredient myFlavor = getRandom(flavors, 1).get(0); 
35 List«Ingredient» myToppings - getRandom(toppings, 3); 
36 myToppings.add(myFlavor); 
37 
38 Order order = new Order(toppings, 1); 
39 orderService.save(order); 
40 log.info("Saved Order ID {}!", order.getId()); 
44 ) 
42 
43 public void makeBadOrder() { 
44 try { 
45 Order order = new Order() 
46 orderService.save(order); // 本 行 用 于 触发 错误 
47 } catch (PersistenceException e) { 
48 log.error("Error saving order!", e); 
49 } 





ol 
© 
i 
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9.5 JCL 


JCL (Java Commons Logging ) 是 另 一 个 可 以 替代 SLFAJ 的 门面 框架 ， 它 能 够 使 日 志 记 录 变 
得 更 简单 。JCL 的 配置 方法 与 SLF4J 类 似 ， 你 必须 把 门面 和 提供 器 之 间 的 链接 添加 到 类 路 径 中 。 
SLEF4J 把 这 种 链接 称 为 “ 绑 定 器 ”， 而 ICL 称 其 为 “桥接 器 ”( bridge )。 同 样 ， 我 们 需要 用 到 四 个 
依赖 项 : JCL API commons-10gging (和 桥接 需 打 交道 )、 log4j-jcl CBAR. HETOEGXÉHGSdH 
息 给 log4j-core ). Log4j log4j-core 和 Jackson jackson-dataformat-yaml ( 负责 配置 























1og4j-core )。 























然后 ， 我 们 使 用 org.apache.commons. logging.LogFactory 创建 org.apache.commons . 
logging.Logs. 


OrderService.java 





15 private static final Log log = LogFactory.getLog(OrderService.class); 











Log4j 中 的 六 种 日 志 级 别 都 可 以 在 ICL 中 使 用 (包括 SLF4J 不 支持 的 “fatal”)。 不 过 ，JCL 
中 日 志方 法 的 限制 性 要 多 一 点 ， 不 支持 参数 ， 所 以 你 必须 先 准 备 日 志 消 息 。 

















OrderService.java 
22 @Transactional 
23 public void save(Order order) { 
24 log.debug("Trying to save order."); 
25 entityManager.persist(order); 
26 } 
OrderMaker.java 
31 public void makeRandomOrder() { 
32 List«Ingredient» flavors = ingredientService.getFlavors(); 
33 List<Ingredient> toppings = ingredientService.getToppings(); 
34 Ingredient myFlavor = getRandom(flavors, 1).get(0); 
35 List<Ingredient> myToppings = getRandom(toppings, 3); 
36 myToppings.add(myFlavor); 
37 
38 Order order = new Order(toppings, 1); 
39 orderService.save(order); 
40 log.info(String.format("Saved Order ID %d!", order.getId())); 
41 } 
42 
43 public void makeBadOrder() { 
44 try { 


45 Order order =new Order(); 
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46 orderService.save(order); // 本 行 用 于 触发 错误 
47 } catch (PersistenceException e) { 

48 log.error("Error saving order!", e); 

49 } 

50 } 

9.6 小 结 








试图 厘清 所 有 Java 日 志方 法 相当 不 易 ， 最 好 代码 库 已 经 确立 了 明确 的 标准 。 最 重要 的 是 你 
要 了 解 两 种 方法 : 直接 使 用 提供 器 或 者 使 用 门面 。 一旦 你 确定 了 要 在 代码 库 中 使 用 的 方法 , REF 
来 就 只 是 选择 正确 的 API To 
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虽然 Java 标准 库 已 经 相当 完善 了 ， 但 是 开源 社区 也 贡献 了 一 些 不 错 的 库 ， 这 些 库 在 某 些 方 
面 表现 得 更 好 ， 所 以 你 需要 熟悉 它们 。 由 于 Java 标准 库 不 支持 JSON， 所 以 我 们 先 介 绍 Google 
的 Gson 和 FasterXML 的 Jackson。 接 着 介绍 一 些 通 用 的 库 , 如 Google 的 Guava 和 Apache Commons。 
最 后 简单 了 解 一 下 JodaTime 库 ， 这 个 日 期 时 间 库 在 Java 8 发 布 之 前 常用 。 
































10.1 JSON 支持 


为 了 演示 POJO 和 ISON 之 间 的 转换 ， 我 们 向 [Scream Web 应 用 程序 中 添加 两 个 新 的 控制 器 
路 由 。 第 一 个 端点 用 于 显示 数据 库 中 的 所 有 订单 ， 第 二 个 端点 使 用 ISON 创建 订单 。 不 过 ， 这 些 
例子 只 为 帮助 你 学 习 使 用 JSON 库 ， 它 们 并 不 是 RESTful Web service 的 例子 。 关 于 使 用 Spring 
Boot 搭建 一 个 真实 Web 服务 的 方法 ， 请 参考 “Building a RESTful Web Service" ^, 








10.1.1 Google Gson 


所 有 Gson 操作 都 依赖 于 一 个 com.google.gson.Gson 实例 。Gson 对 象 是 线程 安全 的 ， 所 以 
通常 只 需要 为 整个 应 用 程序 创建 一 个 即 可 。 虽 然 可 以 使 用 new Gson( ) 创 建 实例 ,但 是 其 默认 设 
置 几 乎 都 不 是 你 所 需要 的 。 其 实 ， 你 可 以 使 用 GsonBuilder 定制 Gson 对 象 。 示 例如 下 。 


















































OrderController.java 
64 private static final Gson GSON = new GsonBuilder() 
65 .setPrettyPrinting() 
66 .setFieldNamingPolicy(FieldNamingPolicy.LOWER CASE WITH UNDERSCORES) 
67 .create(); 





一 旦 有 了 Gson TR, 就 可 以 使 用 fromJson 和 toJson 方法 在 POJO 和 ISON 之 间 进 行 转换 。 
可 以 重 载 这 些 方法 来 处 理 不 同 的 对 象 , 但 我 最 常用 的 是 Gson. fromJson(String json, Class<T> 
classOfT) fI Gson.toJson(Object src). 






































(D https://spring.io/guides/gs/rest-service/ 
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69 
70 
71 
72 
73 
74 
75 
76 
TT 
78 
T9 
80 
81 
82 
83 
84 
85 


新 的 控制 器 路 由 如 下 所 示 。 











OrderController.java 
GRequestMapping(value = "/fromJson", method = RequestMethod.POST, 
produces = "application/json") 
GResponseBody 


public String createOrderFromJson(@RequestBody String orderJson) { 


Order order - GSON.fromJson(orderJson, Order.class); 
orderService.save(order); 
return GSON.toJson(order); 
j 
GRequestMapping(value - "", method - RequestMethod.GET, 
produces = "application/json") 
GResponseBody 


public String all() { 
List«Order» orders - orderService.getAllOrders(); 
return GSON.toJson(orders); 











你 可 以 使 用 UI 创建 一 个 订单 ( /orders/new )， 然 后 导航 到 新 端点 以 查看 订单 。 
[ 


"3d*s 4 
"flavor": { 
"id": 2, 
"name": "Chocolate", 
"unit price": 1.5000 


, 


}, 
"scoops": 2, 
"toppings": [ 
{ 
"Adis <5, 
"name": "Cherry", 
"unit price": 0.2500 
}, 
{ 
"id": 8, 
"name": "Sprinkles", 
"unit price": 0.2500 
j 
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此 外 ,你 还 可 以 使 用 Postman BK curl 等 工具 将 订单 以 POST 方式 发 送 到 位 于 /orders/ fromJson 
的 数据 库 中 ， 如 下 所 示 。 


{ 
"flavor": { 
“a2, 
"name": "Chocolate", 
"unit_price": 1.5000 
h 
"scoops": 2, 
"toppings": [ 
{ 
"id": 5, 
"name": "Cherry", 
"unit price": 0.2500 
}, 
{ 
"id": 7, 
"name": "Peanuts", 
"unit price": 0.2500 
j 
] 
j 


查看 示例 代码 ， 你 会 发 现 我 没有 使 用 Hibernate, Ey Gson 并 未 提供 一 个 简单 的 方法 来 忽略 
单个 属性 ， 而 且 在 Order 和 OrderLineItemss 之 间 存 在 循环 引用 。 稍 后 将 展示 Jackson 如 何在 
Hibernate 中 更 好 地 发 挥 作用 。 








10.1.2 Jackson 


与 Gson 类 似 , 在 Jackson 中 ,所 有 ISON 操作 都 使 用 同一 个 线程 安全 的 对 象 来 完成 所 有 工作 ， 
这 就 是 com. fasterxml . jackson.databind.0bjectMapper。 但 与 Gson 不 同 ，Jackson 中 的 序列 
化 和 反 序 列 化 配置 通常 不 在 Ob jectMapper 级 别 上 进行 ， 而 是 在 各 个 对 象 上 进行 。 


与 介绍 过 的 其 他 工具 一 样 ，Jackson 使 用 注解 进行 配置 。 默 认 情 况 下 ， 使 用 getter 和 setter 方 
法 判断 一 个 对 象 应 该 包含 哪些 字段 ， 所 以 如 果 你 觉得 默认 设置 可 行 ， 就 不 必用 注解 了 。 不 过 , 大 
多 数 使 用 JSON 的 应 用 程序 对 ISON 的 形成 方式 有 一 些 特殊 要 求 , 尤其 是 Web 服务 。 我 们 将 使 用 
@JsonProperty(String name) 和 @JsonIgnore 注解 ， 但 是 ， 除 此 之 外 ， 还 有 许多 其 他 注解 可 以 
满足 你 的 需求 。 


在 OrderLineItem 类 中 ， 我 们 需要 忽略 Order 引用 ， 防 止 出 现 前 面 提 过 的 循环 引用 问题 。 
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OrderLineltem.java 
17 @ManyToOne( fetch = FetchType.LAZY) 
18 @JoinColumn(name = "purchase id") 
19 @JsonIgnore 
20 private Order order; 





此 外 ， 由 于 Jackson 使 用 getter 方法 来 确定 需要 序列 化 的 属性 ， 我 们 还 要 忽略 负责 计算 的 
getLineItemCost 方法 。 








OrderLineltem.java 
TA @JsonIgnore 
72 public BigDecimal getLineItemCost() { 
73 return ingredient --null|| units --null 
74 ? BigDecimal . ZERO 
75 : ingredient.getUnitPrice().multiply(BigDecimal.valueOf(units)); 
76 } 














对 于 ISON, 我 更 喜欢 使 用 snake_case, 所 以 使 用 @JsonProperty 可 以 更 改 特定 属性 的 名 称 ”， 
如 下 所 示 。 


















































Order.java 
77 GJsonProperty("total price") 
78 public BigDecimal getTotalPrice() { 
ObjectMapper 有 几 个 readValue 和 writeValue 方法 ， 类 似 于 Gson 的 fromJson 和 toJson 
方法 。 它 们 在 控制 器 中 的 使 用 方法 如 下 。 
OrderController.java 
67 private static final ObjectMapper MAPPER = new ObjectMapper(); 
68 
69 GRequestMapping(value - "/fromJson", method - RequestMethod.POST, 
170 produces = "application/ json") 
TA @ResponseBody 
T2 public String createOrderFromJson(GRequestBody String orderJson) 
73 throws Exception { 
74 Order order = MAPPER.readValue(orderJson, Order.class); 
75 order .getOrderLineItems().forEach(li -> li.setOrder(order)); 
76 orderService.save(order); 
"TT 























(D 也 可 以 使 用 MAPPER. setPropertyNamingStrategy(PropertyNamingStrategy.SNAKE CASE) KESTA. 
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78 return MAPPER.writeValueAsString(order); 

T9 } 

80 

81 GRequestMapping(value = "", method = RequestMethod.GET, 
82 produces = "application/json") 

83 GResponseBody 

84 public String all() throws Exception { 

85 List«Order» orders - orderService.getAllOrders(); 
86 return MAPPER 

87 .writerWithDefaultPrettyPrinter() 

88 .writeValueAsString(orders) ; 

89 } 





如 何在 两 个 库 之 间 做 选择 主要 取决 于 你 需要 的 特性 。Gson 容易 设置 ， 但 不 如 Jackson 灵活 。 
性 能 上 ，Jackson 在 人 处理 大 型 文件 时 表现 得 更 出 色 ， 而 Gson 在 处 理 小 文件 时 表现 得 更 好 。 
102 ”实用 工具 库 


Java 有 很 多 通用 的 实用 工具 库 。 实 际 上 ,每 个 公司 可 能 有 自己 的 实用 工具 库 。 下 面 重点 介绍 
两 个 常用 的 实用 工具 库 : Guava 和 Apache Commons。 


























10.2.1 Guava 


1. 集合 





Guava 提供 了 许多 创建 集合 的 实用 方法 ， 这 些 方法 方便 易 用 。 例 如 ,我 们 经 常 通过 下 面 的 方 
式 创 建 由 少量 对 象 组 成 的 集合 。 

List«String» myList = Arrays.asList("blue", "green", "yellow"); 

Set«String» mySet = new HashSet<>(); 

mySet.add("blue"); 


mySet.add("green"); 
mySet.add("yellow"); 


使 用 Guava 库 ， 做 法 如 下 。 


List«String» myList = ImmutableList.of("blue", "green", "yellow"); 





Set«String» mySet - ImmutableSet.of("blue", "green", "yellow"); 
当然 ， 如 果 你 用 的 是 Java 9， 也 可 以 使 用 内 置 的 List.of() 方 法 。 


Guava 库 中 还 包含 一 些 新 的 集合 类 型 ， 比 如 Multiset、BiMap 和 Table。 
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BiMap«String, String» usersToEmail = HashBiMap.create(); 
usersToEmail.put("footballfan", "bill@example.com"); 
usersToEmail.put("dragon", "sue@something.org"); 


assert "dragon".equals(usersToEmail.inverse( ).get("sueGsomething.org")); 
Multiset«String» multi - HashMultiset.create(); 

multi.add("a"); 

multi.add("b"); 

multi.add("b"); 

multi.add("c"); 

multi.add("c"); 








multi.add("c"); 
assert 3 -- multi.count("c" 


Table«Integer, String, Double» data - HashBasedTable.create(); 
data.put(1, "Abe Bondley", 68000.00d); 

data.put(2, "Helli Sivewright", 54000.00d); 

data.put(3, "Kevan Loughtan", 45000.00d); 


assert 45000.00d -- data.row(3).get("Kevan Loughtan"); 
assert 68000.00d -- data.column("Abe Bondley").get(1); 


2. 字符 串 


Java 中 ， 通 常 可 以 使 用 String.split() 拆 分 字符 串 ， 但 有 时 它 的 行为 不 可 靠 ， 对 于 用 户 提 
供 的 数据 ， 它 可 能 无 法 给 出 理想 的 结果 。 而 Guava 中 的 Splitter 类 拆 分 字符 串 的 行为 很 明确 ， 
它 会 完全 按照 设置 执行 。 
































Iterable«String» it = Splitter.on(',') 
.trimResults() 
.omitEmptyStrings() 
.split("foo,bar,, qux"); 


List«String» strings = Lists.newArrayList(it); 


assert 3 -- strings.size(); 
assert "foo".equals(strings.get(0)); 
assert "bar".equals(strings.get(1)); 


assert "qux".equals(strings.get(2)); 


此 外 ， 还 有 一 些 实用 工具 方法 可 以 转换 大 小 写 ， 如 下 所 示 。 


assert "hello-world".equals(CaseFormat.UPPER UNDERSCORE 
.to(CaseFormat.LOWER HYPHEN, "HELLO. WORLD")); 
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3. 缓存 


你 可 能 听 过 这 样 的 话 :“ 计 算 机 科学 中 只 有 两 件 难事 : 缓存 失效 和 命名 。”Guava 库 力 图 简化 
第 一 件 事 。 缓 存在 很 多 方面 都 很 有 用, 但 是 不 易 实现 。 我 们 可 以 使 用 Guava 库 来 做 这 项 工作 , 这 
能 大 幅 降低 犯错 的 风险 。 

















final AtomicInteger cacheHits = new AtomicInteger(); 
LoadingCache«String, String» values - CacheBuilder.newBuilder() 
.maximumSize(10) 
.expireAfterAccess(1, TimeUnit.HOURS) 
.build(new CacheLoader«String, String»() ( 
GOverride 
public String load(String key) throws Exception { 
// 一 些 开 销 很 大 的 操作 
Thread.sleep(1000); 
cacheHits.incrementAndGet(); 


return key + "foo"; 


" 


} 
); 


values.get("abc"); 
values.get("abc"); 
values.get("abc"); 


assert 1 -- cacheHits.get(); 


4. 其 他 


关于 Guava 库 还 有 很 多 内 容 ,这 里 不 再 多 讲 , 但 是 这 些 内 容 值得 好 好 学 习 。 请 注意 ， 如 果 你 
用 的 是 最 新 版 本 的 Java, JB Guava 中 的 某 些 类 可 能 无 法 正常 工作 , 比如 在 很 大 程度 上 com. google. 
common.base.Optional 被 java.util.Optional 取代 了 。 





10.2.2 Apache Commons 





Apache Commons 库 包含 大 量 有 用 的 工具 ， 有 助 于 Java 开发 者 完成 一 些 管见 任务 。 事 实 上 ， 
第 9 章 介绍 过 一 个 库 了 。 此 外 ,还 有 其 他 一 些 实用 工具 ， 下 面 重点 介绍 其 中 几 个 。 


WT THZSN 


1. commons. lang 库 





commons.lang 库 的 设计 目标 是 扩展 java.lang PAZ. StringUtils 类 扩展 了 String 
类 中 的 许多 方法 ， 并 且 是 null 安全 的 。 如 下 所 示 。 


assert !StringUtils.endsWith(null, "foo"); 


assert null -- StringUtils.reverse(null); 
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对 于 常见 String 任务 ，commons .1ang 也 提供 了 很 多 有 用 的 方法 。 


assert StringUtils.isEmpty(null); 
assert StringUtils.isEmpty(""); 


assert StringUtils.isNumeric("123"); 
assert "00123".equals(StringUtils.leftPad("123", 5, '@')); 


assert "Hello, World!" 
.equals(StringUtils.normalizeSpace(" Hello, World! ")); 





assert "Hello".equals(StringUtils.capitalize("hello")); 


接触 Java 这 么 多 年 ,我 至 今 不 清楚 java.util.Random 为 什么 不 提供 生成 特定 范围 内 随机 数 
的 方法 ， 而 RandomUtils 加 入 了 这 些 方法 。 





int random = RandomUtils.nextInt(5, 10); 
assert random »- 5 && random « 10; 


ClassUtils 类 简化 了 实际 类 的 使 用 方法 ， 并 且 它 不 使 用 反射 ， 因 此 速度 很 快 。 


assert "java.lang".equals(ClassUtils.getPackageName(String.class)); 














assert "String".equals(ClassUtils.getSimpleName(String.class)); 


2. commons.collections 





Tr 





Commons Collections 库 新 增 了 几 个 集合 类 型 和 实用 工具 。 类 似 于 Guava, 它 支 持 双向 Map. 





BidiMap«String, String» usersToEmail = new DualHashBidiMap<>(); 
usersToEmail.put("footballfan", "bill@example.com"); 





usersToEmail.put("dragon", "sue@something.org"); 


assert "dragon".equals(usersToEmail.getKey("sueGsomething.org")); 


此 外 ,还 有 SetUtils 2É, ListUtils 类 和 MapUtils 类 ， 用 于 处 理 相应 的 集合 类 型 。 示 例 
如 下 。 





Set«Integer» a = new HashSet«»(Arrays.asList(1,2,3,4)); 
Set«Integer» b - new HashSet«»(Arrays.asList(1,2,4)); 
SetUtils.SetView«Integer» result - SetUtils.difference(a, b); 


assert 1 -- result.size(); 
assert result.contains(3); 
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3. commons .io HE 


Java IO 操作 烦琐 是 出 了 名 的 ， 这 个 问题 在 Java 7 中 发 布 的 nio 包 中 有 了 一 些 改善 ， 但 是 在 
许多 常见 任务 中 使 用 时 仍然 显得 繁复 。Apache commons. io 库 抽象 出 了 很 多 样板 代码 。 当 你 使 用 
的 另 一 个 库 没 有 提供 理想 的 数据 时 ， 这 个 库 特 别 有 用 。 例 如 ， 假 设 你 得 到 了 一 个 InputStream, 
但 你 想 要 一 个 字符 串 。 

final String DROM = "src/test/resources/declaration.txt"; 


File declaration - Paths.get(DROM).toFile(); 
InputStream is - new FileInputStream(declaration); 








char[] read - IOUtils.toCharArray(is, Charset.defaultCharset()); 


is.close(); 


assert new String(read).startsWith("The representatives"); 


类 似 地 ， 把 数据 流 复制 给 Writer BK Reader 的 方法 如 下 。 





StringWriter sw = new StringWriter(); 
is = new FileInputStream(declaration); 
IOUtils.copy(is, sw, Charset.defaultCharset()); 


is.close(); 


assert sw.toString().startsWith("The representatives"); 


FileUtils 类 提供 了 一 些 有 用 的 方法 ， 便 于 我 们 使 用 文件 和 目录 。 比 如 ， 只 需 一 行 代码 就 可 
以 把 一 个 File 放 入 一 个 String 中 。 


此 外 ， 我 们 还 可 以 遍历 某 个 目录 ,并且 有 选择 地 忽略 此 目录 下 的 某 些 文件 或 目录 。 


final String DROM = "src/test/resources/declaration.txt"; 

File declaration - Paths.get(DROM).toFile(); 

String s - FileUtils.readFileToString(declaration, 
Charset.defaultCharset()); 








assert s.startsWith("The representatives"); 


4. 其 他 


类 似 于 Guava J, Apache Commons 库 也 提供 了 大 量 有 用 的 工具 ， 这 里 不 一 一 列 出 了 。 你 可 
以 去 其 官网 详细 了 解 ， 并 尝试 将 其 用 于 下 一 个 项 目 。 
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10.3 Joda Time 库 


[4 


(如 


落后 警告 

在 Java 8 之 前 ，jJava 日 期 时 间 库 使 用 起 来 既 容 易 出 错 又 很 麻烦 。 于 是 Joda Time 
库 的 创建 者 们 便 考虑 编写 一 个 易 用 且 安 全 的 日 期 时 间 库 ,Java8 引 入 了 java.time 
包 ( 从 Joda Time 库 中 借鉴 了 很 多 )， 并 且 修 正 了 旧 java.util.Date 类 的 许多 问 
题 。 不过， 即便 你 所 在 的 团队 已 经 迁移 到 了 Java8, 在 Java8 之 前 的 项 目 中 ， 你 
仍然 可 能 见 到 Joda Time 库 。 





Joda Time 库 的 核心 是 Instant 类 ， 表 示 UNIX 新 纪元 时 间 轴 上 一 个 瞬时 的 点 。 通 常 ， 无 须 
创建 Instant 对 象 ， 但 是 你 要 使 用 它们 把 Joda Time 对 象 转换 成 其 他 Joda Time 对 象 。 





assert 1483246800000L == Instant.parse("2017-01-01").getMillis(); 
assert 1483246800000L == Instant.parse("2017-01-02") 
.minus(24 * 60 * 60 * 1000) 


.getMillis(); 


assert Instant.parse("1900-01-01").getMillis() < 0; 

















DateTime 对 象 极其 强大 ， 它 可 能 是 最 常用 的 对 象 ， 绝 大 部 分 应 用 程序 都 会 用 到 。 你 可 以 使 
用 整数 手动 创建 它 ， 也 可 以 通过 解析 字符 串 或 者 从 Instant 对 象 转换 得 到 它 。 























DateTime dt = new DateTime(2017, 1, 1, @, 1, 23); 
System.out.println(dt.toString()); 
assert dt.toString().startsWith("20177-01-041T00 01 : 23.000") ; 


assert DateTime.now().isAfter(Instant.parse("2017-01-01")); 








Period 类 表示 两 个 时 间 点 之 间 的 时 间 段 ， 便 于 确定 事件 间 的 时 间 间 隔 。 它 并 未 精确 至 毫秒 ， 
所 以 通常 用 于 描述 人 类 的 不 同体 验 , 比如 某 个 事件 发 生 的 天 数 、 计 算 某 人 从 出 生 之 日 起 的 年 龄 等 


FH 
IN 























你 需要 精确 到 毫秒 ， 请 使 用 Duration 类 )。 重 要 的 是 它 能 正确 处 理 夏令 时 和 闲 年 。 虽 然 


Period 是 一 个 具体 类 ， 但 它 与 Years 、Months、 Days 等 子 类 配合 使 用 更 加 方便 。 


处 理 时 


DateTime start = new DateTime(2017, 1, 1, 0, 0); 

DateTime end = new DateTime(2018, 1, 1, ©, 0); 

assert 1 -- Years.yearsBetween(start, end).getYears(); 

assert 525600 -- Minutes.minutesBetween(start, end).getMinutes(); 





区 很 麻烦 ， 但 是 借助 Joda Time 库 ， 你 可 以 很 轻松 处 理 它们 。 除 非特 别 指定 ， 否 则 




















DateTime 对 象 使 用 系统 时 区 。 清楚 起 见 , 创建 DateTime 时 , 最 好 使 用 可 以 接收 时 区 的 重 载 构造 
函数 ， 即 使 时 区 保持 不 变 ， 也 应 这 样 做 。 
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DateTimeZone UTC = DateTimeZone.UTC; 
DateTimeZone NYC = DateTimeZone.forID("America/New. York"); 


DateTime utc = new DateTime(2017, 1, 1, 0, ©, UTC); 
DateTime nyc = new DateTime(2017, 1, 1, @, @, NYC); 


assert nyc.getMillis() -- utc.plusHours(5).getMillis(); 


Joda Time 库 还 有 一 个 很 好 的 特性 ， 即 其 对 象 都 是 不 可 变 的 且 是 线程 安全 的 ， 当 然 ， 前 提 是 
你 未 明确 选用 MutableDateTime 类 。 















































Q Java E: java.util.Date 
相 比 于 Joda Time, !H 15 Data 类 有 哪些 不 足 之 处 呢 ? 确实 有 很 多 。Jon Skeet 4 +h 
客 对 此 做 了 很 好 的 总 结 , 但 也 许 最 糟糕 的 是 类 名 与 其 功能 脱节 。java.util.Date 
不 表示 日 期 而 是 表示 菜 个 瞬间 ， 因 此 getMonth()、toGMTString() 等 操作 没 
有 实际 意义 。 事 实 上 ， 这 些 方法 (及 其 他 一 些 方法 ) 都 已 经 弃 用 了 。 


10.4 ”小 结 


Guava 和 Apache Commons 可 以 减少 样本 代码 的 使 用 , 扩展 Java 语言 的 功能 ， 同 时 减少 错误 
的 发 生 。 当 然 ， 你 并 不 需要 在 每 个 项 目 中 都 使 用 这 些 库 , 但 对 于 大 型 代码 库 来 说 ,它们 的 确 很 有 
用 。 此 外 ,还 要 记 住 , 你 可 以 很 容易 地 通过 添加 一 些 常 用 的 依赖 项 来 扩展 项 目 。 因 此 ,我 们 要 学 
会 适当 地 运用 这 些 库 ,并 在 把 它们 添加 到 项 目 之 前 确认 它们 会 发 挥 作用 。 最 后 ， 如 果 你 正在 处 理 
一 个 遗留 应 用 程序 (Java 8 之 前 的 )， 那 相 比 于 标准 库 中 的 Date 类 ， 绝 大 数 情况 下 ，Joda Time 
库 都 是 更 好 的 选择 。 
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Docker 








Docker 是 一 个 开源 应 用 容器 引擎 ， 人 允许 应 用 程序 在 主机 系统 的 隔离 环境 中 运行 。Docker 和 
虚拟 机 在 概念 上 类 似 ,但 是 它们 之 间 的 关键 区 别 是 : Docker 容器 并 不 包含 整个 操作 系统 。 相 反 ， 
它们 只 是 些小 的 软件 包 ， 内 核 操 作 全 部 委托 给 主机 。 因 此 它们 很 小 (通常 只 有 几 百 MB )， 非常 
灵活 且 高 效 。 


在 Java 体系 中 ，Docker 允许 我 们 把 应 用 程序 的 所 有 支持 软件 捆绑 在 一 起 ， 并 把 它们 部 署 在 
服务 器 的 一 个 独立 区 域 中 。 比 如 ， 有 一 个 打包 成 .war 文件 的 应 用 程序 部 署 在 Tomcat 中 ， 后 端 连 
接着 一 个 Postgres 数据 库 ， 所 有 这 些 都 可 以 部 署 到 一 个 容器 之 中 。 移 除 或 者 重新 部 署 应 用 程序 也 


很 简单 ， 只 需要 执行 一 条 Docker 提交 命令 即 可 。 


























p> 超前 警告 : Docker 
虽然 Docker 并 非 全 新 的 东西 ， 但 是 很 多 公司 都 没有 相应 的 架构 支持 这 样 的 容器 
技术 。 对 于 应 用 程序 开发 和 部 署 来 说 ，Docker 是 一 种 新 颖 且 强 大 的 技术 ， 整 个 
行业 正 朝 着 容器 化 方向 发 展 。 你 所 在 的 公司 可 能 没有 马上 采用 它 。 如 果 你 想 轻松 
入 门 ， 可 以 在 项 目 开发 中 试用 Docker， 开 展 一 些 峰 值 研究 和 项 目测 试 工作 。 


A.1 创建 Docker 镜像 


部 署 Docker 容器 的 第 一 步 是 创建 一 个 Docker 镜像 。 这 个 镜像 包含 应 用 程序 的 所 有 组 件 ， 并 
长 期 存在 于 Docker 实例 中 。 重 要 的 是 ， 镜 像 是 可 以 分 层 琶 加 的 。 所 以 ， 通常 在 基本 镜像 的 基础 
Es 根据 应 用 程序 的 需求 做 相应 调整 。 这 可 以 通过 Docker file 来 完成 o 


Dockerfile 多 以 FROM 命令 开头 , 这 个 命令 告诉 Docker 启动 哪个 基础 镜像 。 下面 列 出 了 Java 
开发 者 们 常用 的 一 些 基础 镜像 。 




































































DQ openjdk: Java JDK 

D azul/zulu-openjdk: 男 一 个 JDK 

口 tomcat: Tomcat 应 用 程序 服务 器 

口 jboss/wildfly: Wildfly 应 用 程序 服务 器 
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O alpine: 微型 Linux 内 核 
你 可 以 使 用 image:tag (镜像 :标签 ) 这 种 格式 来 指定 具体 使 用 的 镜像 版 本 ， 比 如 


openjdk:8-jdk-alpine。 


此 外 ，Dockerfile 还 包含 大 量 其 他 命令 ， 像 ADD ( 添加 资源 )、ENV ( 设置 环境 变量 ) 等 。 
比如 ， 下 面 这 个 Dockerfile 用 于 创建 一 个 Spring Boot Web 应 用 程序 镜像 。 





Dockerfile 





1 FROM openjdk:8-jdk-alpine 
2 ADD build/libs/iscream-web-0.0.1-SNAPSHOT. jar app. jar 
3  ENTRYPOINT [ "sh", "-c", "java -jar /app.jar" | 








ENTRYPOINT 告诉 Docker 容器 启动 时 要 运行 什么 。 这 一 点 非常 重要 ， 和 否则 ，Docker 容器 只 会 
启动 微型 Alpine Linux， 其 他 什么 也 不 做 。 
实际 创建 镜像 时 ， 我 们 可 以 执行 docker build --tag=iscream 命令 ， 其 中 tag 是 可 选 的 ， 


如 果 不 指定 , Docker 会 随机 为 镜像 定 一 个 名 字 。 首 次 创建 镜像 需要 一 分 钟 左右 , 因为 所 有 基础 镜 
像 都 要 从 网 上 下 载 。 但 是 之 后 再 创建 时 ， 速 度 会 非常 快 ， 因 为 Docker 已 经 保存 了 这 些 基础 镜像 。 




















A.2 部署 Docker 容器 


当 镜 像 创建 好 之 后 , 就 可 以 从 它 开始 创建 一 个 或 多 个 容器 了 。 通常 容器 都 是 相对 短期 且 一 次 
性 的 。 当 需要 长 久 存 储 数据 时 ， 我 们 会 用 到 Docker 数据 卷 。 当 你 需要 部 署 新 版 本 的 代码 或 者 使 
用 不 同 参数 来 配置 应 用 程序 时 ， 原 有 的 容器 就 会 被 废弃 。 你 甚至 可 以 创建 高 替换 性 的 容器 ， 当 它 
们 的 工作 结束 时 ，Docker 会 自动 将 其 删除 。 这 对 于 批 处 理 或 ETL 等 工作 非常 有 用 ， 因 为 在 完成 
这 些 工 作 后 相应 的 容器 就 不 再 驻 留 了 。 

你 可 以 使 用 docker run -d -p 8080:8080 iscream 创建 一 个 非常 简单 的 容器 。 该 命令 会 在 


Ja (-d) 启动 一 个 iscream 镜像 的 实例 ， 随 机 赋予 它 一 个 名 字 ， 指 定 内 部 端口 8080 到 主机 端 
口 8080 (-p )。 上 面 的 命令 提交 之 后 ， 你 可 以 前 往 http://localhost:8080/orders/new page 查看 程序 。 












































你 可 以 运行 docker ps 命令 来 查看 容器 名 称 ， 通 过 docker stop container name 命令 停 
止 指定 的 容器 ， 以 及 运行 docker rm container. name 命令 将 其 删除 。 


当然 ，docker run 命令 还 有 很 多 参数 ， 常 用 参数 如 下 。 

















D docker run -it -p 8080:8080 iscream: 以 “交互 ”模式 运行 一 个 容器 。 
QO docker run -d --rm -p 8080:8080 iscream: 当 容 器 停止 时 自动 删除 它 。 
口 docker run -d --name iscream dev -p 8080:8080 iscream: 把 容器 实例 命名 为 Iscream devo 
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A.3 注意 事项 


A.3.1 内 存 


如 果 你 的 Docker 主机 上 运行 着 多 个 容器 ( 应 该 这 样 做 !1 )， 最 好 适当 限制 容器 的 可 用 内 存 。 
不 然 ， 一 个 应 用 程序 的 内 存 泄露 可 能 对 其 他 应 用 程序 产生 不 良 影响 。Docker 允许 使 用 -m 标记 为 
某 个 容器 指定 其 可 用 内 存 , 但 关键 是 你 还 应 在 JVM 层面 限制 内 存 大 小 ( 更 多 细节 , 请 阅读 Rafael 
Benevides 撰写 的 “Java Inside Docker: What You Must Know to Not FAIL”)， 有 如 下 两 步 。 





























首先 ， 调 整 Dockerfile， 把 $JAVA_OPTS 添加 到 java 命令 。 





ENTRYPOINT [ "sh", "-c", "java $JAVA_OPTS -jar /app.jar" ] 


然后 ， 创 建 容器 时 指定 容 需 的 内 存 大 小 ， 并 使 用 -e 参数 设置 $JAVA_OPTS 。 


docker run -d -p 8080:8080 -m 1536M -e JAVA OPTS-'-Xmx1024m' iscream 








A.3.2 JDK 


第 1 章 提 到 过 , Java IDK 有 多 个 版 本 。 根据 Oracle 的 许可 协议 , 在 Docker 中 使 用 Oracle JDK 
似乎 是 不 合法 的 。 解 决 办 法 是 使 用 自由 许可 的 JDK， 比 如 OpenJDK。 这 适用 于 大 多 数 情 况 。 不 
ib, 由 于 标记 名 称 的 变化 , 你 可 能 不 小 心 使 用 了 自己 并 不 想 用 的 JDK 版 本 。 例如, 8-jdk-alpine 
并 未 具体 指定 IDK 版 本 ， 它 可 以 指 Java 8 的 任何 版 本 。 


为 了 解决 这 个 问题 ， 我 们 可 以 使 用 更 具体 的 标签 名 称 ， 比 如 8u131-jdk-alpine (但 还 是 没 
有 指向 特定 的 JDK 提交 )。 或 者 , 你 也 可 以 选用 一 个 经 过 正规 测试 的 JDK， 比 如 Zulu， 其 标签 和 
特定 提交 相关 联 ， 比 如 8u144-8.23.0.3。 


不 管 怎样 ， 我 最 常 使 用 OpenJDK， 并 且 不 觉得 版 本 问题 有 多 么 困扰 。 我 相信 OpenIDK 经 过 
了 很 好 的 测试 。 不过， 对 于 不 容许 出 现任 何 JDK bug 的 重要 软件 ， 我 不 会 使 用 它 。 至 于 你 ， 请 根 
据 实际 情况 选择 合适 的 JDK。 
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